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:
Dalla pagina Spanner della console Google Cloud, seleziona un'istanza.
Seleziona un database da esaminare.
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.
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
- Impara a riconoscere gli pattern comuni nelle mappe termiche.
- Scopri come esplorare una mappa termica in modo approfondito.
- Scopri di più sulle metriche che puoi visualizzare in una mappa termica.