Key Visualizer ist in Spanner standardmäßig aktiviert.
Hinweise
Zum Ansehen von Key Visualizer benötigen Sie die folgende IAM-Berechtigung (Identity and Access Management):
spanner.databases.read
Wenn Sie Nutzer mit einer detaillierten Zugriffssteuerung sind, muss Ihnen Zugriff auf Folgendes gewährt worden sein:
- die Systemrolle
spanner_sys_reader
oder eine ihrer Mitgliederrollen
Weitere Informationen finden Sie unter Detaillierte Zugriffssteuerung und Rollen für detaillierte Zugriffssteuerung.
Auf die Key Visualizer-Oberflä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 auf der Seite "Spanner" in der Google Cloud Console eine Instanz aus.
Wählen Sie eine Datenbank zur Untersuchung aus.
Wählen Sie im Navigationsmenü unter Beobachtbarkeit die Option Key Visualizer aus.
Key Visualizer deaktivieren
Key Visualizer wird von der Datenbankoption enable_key_visualizer
gesteuert. Der Standardwert ist true
.
Wenn Sie Key Visualizer deaktivieren möchten, legen Sie den Wert der Datenbankoption enable_key_visualizer
auf false
fest. 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 Anweisung 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 vorherigen Anleitung, um Key Visualizer wieder zu aktivieren und den Wert der Datenbankoption enable_key_visualizer
auf true
zu setzen.
Bei der erneuten Aktivierung einer Datenbank ist die Key Visualizer-Heatmap in den ersten Minuten 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