Key Visualizer ist in Spanner standardmäßig aktiviert.
Hinweis
Zum Aufrufen des Schlüsselvisualisierers benötigen Sie die folgende IAM-Berechtigung (Identity and Access Management):
spanner.databases.read
Wenn Sie die detaillierte Zugriffssteuerung verwenden, müssen Sie Zugriff auf Folgendes haben:
- die
spanner_sys_reader
-Systemrolle oder eine ihrer Mitgliedsrollen.
Weitere Informationen finden Sie unter Über die detaillierte Zugriffssteuerung und Detailgenaue Rollen für das Zugriffssteuerungssystem.
Auf die Key Visualizer-Benutzeroberfläche zugreifen
Sie greifen über die Google Cloud Console auf das Key Visualizer-Tool zu.
So greifen Sie auf Key Visualizer zu:
Wählen Sie in der Google Cloud Console auf der Seite „Spanner“ eine Instanz aus.
Wählen Sie eine Datenbank zur Untersuchung aus.
Wählen Sie im Navigationsmenü unter Observability die Option Key Visualizer aus.
Key Visualizer deaktivieren
Key Visualizer wird vom enable_key_visualizer
gesteuert
Datenbankoption. Der Standardwert ist true
.
Wenn Sie Key Visualizer deaktivieren möchten, legen Sie den Wert für enable_key_visualizer
fest
Datenbankoption auf false
. Die DDL-Syntax zum Deaktivieren von Key Visualizer lautet:
ALTER DATABASE `database_id` SET OPTIONS (enable_key_visualizer=false)
Wenn Ihre Datenbank-ID andere Zeichen als Buchstaben, Zahlen oder Unterstriche enthält, müssen Sie die ID in Graviszeichen (``) setzen.
Die Erklärung kann mit einem gcloud-Befehl oder in einer UpdateDatabaseDdl
-gRPC/REST-Anfrage gesendet werden. Beispiel:
gcloud spanner databases ddl update database_id --instance=instance_id \
--ddl='ALTER DATABASE `database_id` SET OPTIONS ( enable_key_visualizer=false )'
Nachdem Sie den Wert für enable_key_visualizer
explizit festgelegt haben, können Sie dessen Wert prüfen. Klicken Sie dazu auf der Übersichtsseite auf ÄQUIVALENTE DDL ANSEHEN oder verwenden Sie den gcloud-ddl describe
Befehl:
gcloud spanner databases ddl describe `database_id` --instance=instance_id
Key Visualizer wieder aktivieren
Folgen Sie der Anleitung oben, um den Wert der Datenbankoption enable_key_visualizer
auf true
zu setzen und Key Visualizer wieder zu aktivieren.
Wenn Key Visualizer zum ersten Mal für eine Datenbank neu aktiviert wird, ist die Key Visualizer-Heatmap ein paar Minuten lang leer, während Spanner Messwerte erfasst.
Nächste Schritte
- Wie Sie gängige Muster in Heatmaps erkennen
- Wie Sie eine Heatmap im Detail untersuchen
- Welche Messwerte Sie in einer Heatmap abrufen können