Key Visualizer aufrufen

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:

  1. Wählen Sie auf der Seite "Spanner" in der Google Cloud Console eine Instanz aus.

  2. Wählen Sie eine Datenbank zur Untersuchung aus.

  3. 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