Key Visualizer

Key Visualizer è abilitato in Spanner per impostazione predefinita.

Prima di iniziare

Per visualizzare Key Visualizer, devi disporre della seguente autorizzazione Identity and Access Management (IAM):

  • spanner.databases.read

Se sei un utente con controllo granulare dell'accesso, devi aver ricevuto l'accesso a:

  • Il ruolo di sistema spanner_sys_reader o uno dei suoi ruoli membri.

Per ulteriori informazioni, consulta Informazioni sul controllo dell'accesso granulare e Ruoli di sistema per il controllo dell'accesso granulare.

Accedere all'interfaccia di Key Visualizer

Puoi accedere allo strumento Key Visualizer dalla console Google Cloud.

Per accedere a Key Visualizer:

  1. Nella pagina Spanner della console Google Cloud, seleziona un'istanza.

  2. Seleziona un database da esaminare.

  3. Nel menu di navigazione, in Osservabilità, seleziona Key Visualizer.

Disattivare Key Visualizer

Key Visualizer è controllato dall'opzione database enable_key_visualizer. Il valore predefinito è true.

Per disattivare Key Visualizer, imposta il valore dell'opzione del database enable_key_visualizer su false. La sintassi DDL per disabilitare Key Visualizer è:

ALTER DATABASE `database_id` SET OPTIONS (enable_key_visualizer=false)

Se l'ID database contiene caratteri diversi da lettere, numeri o trattini bassi, assicurati di racchiuderlo tra barre graffe (``).

L'istruzione può essere inviata utilizzando un comando gcloud o in una richiesta UpdateDatabaseDdl gRPC/REST. Ad esempio:

gcloud spanner databases ddl update database_id --instance=instance_id \
    --ddl='ALTER DATABASE `database_id` SET OPTIONS ( enable_key_visualizer=false )'

Dopo aver impostato esplicitamente il valore per enable_key_visualizer, puoi controllarne il valore facendo clic su MOSTRA DDL EQUIVALENTE nella pagina Panoramica o utilizzando il comando gcloud ddl describe:

gcloud spanner databases ddl describe `database_id` --instance=instance_id

Riattiva Key Visualizer

Per riattivare Key Visualizer, segui le istruzioni precedenti, impostando il valore dell'opzione di database enable_key_visualizer su true.

Quando viene riattivata per la prima volta per un database, la mappa di calore di Key Visualizer sarà vuota per i primi minuti mentre Spanner raccoglie le metriche.

Passaggi successivi