Introduzione a Key Visualizer

Panoramica

Key Visualizer è abilitato per impostazione predefinita.

In alcune situazioni i dati potrebbero non essere immediatamente disponibili in Key Visualizer.

  • Le statistiche sullo spazio di archiviazione e sul traffico per i database appena creati potrebbero non essere disponibili immediatamente.
  • Le statistiche sul traffico per le righe appena inserite possono essere attribuite a intervalli di chiavi esistenti.

Prima di iniziare

Per visualizzare Key Visualizer, devi disporre di:

  • Se sei un utente con controllo dell'accesso granulare, devi aver ricevuto l'accesso al ruolo di sistema spanner_sys_reader o a uno dei suoi ruoli membro.

  • Se non sei un utente con controllo dell'accesso granulare, devi disporre della seguente autorizzazione IAM (Identity and Access Management):

    • spanner.databases.read

Per saperne di più, consulta Informazioni sul controllo dell'accesso granulare e Ruoli di sistema di controllo dell'accesso granulare degli accessi.

Interfaccia Key Visualizer

Puoi accedere allo strumento Key Visualizer dalla console Google Cloud.

Per accedere a Key Visualizer:

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

  2. Seleziona un database da esaminare.

  3. Solo per utenti con controllo dell'accesso granulare: nella pagina Panoramica del database, nel campo Ruolo attuale, specifica il ruolo di sistema spanner_sys_reader o un ruolo che è membro (o discendente di) spanner_sys_reader.

    Per saperne di più, consulta Informazioni sul controllo dell'accesso granulare e Ruoli di sistema di controllo dell'accesso granulare degli accessi.

  4. Nel menu di navigazione a sinistra, in Osservabilità, seleziona Key Visualizer.

Disattiva Key Visualizer

L'abilitazione di Key Visualizer è controllata dall'opzione di database enable_key_visualizer. Il valore predefinito è true.

Per disabilitare 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 del database contiene caratteri diversi da lettere, numeri o trattini bassi, assicurati di racchiudere l'ID tra apici inversi (``).

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 di enable_key_visualizer, puoi controllarne il valore facendo clic su MOSTRA DDL EQUIVALENTE nella pagina di riepilogo o utilizzando il comando gcloud ddl describe:

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

Riattiva Key Visualizer

Per riabilitare Key Visualizer, segui le istruzioni in Disabilita Key Visualizer, impostando il valore dell'opzione di database enable_key_visualizer su true.

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

Passaggi successivi