Key Visualizer

O Key Visualizer está ativado no Spanner por padrão.

Antes de começar

Para acessar o Key Visualizer, você precisa da seguinte permissão do Identity and Access Management (IAM):

  • spanner.databases.read

Se você é um usuário de controle de acesso granular, precisa ter acesso a:

  • a função do sistema spanner_sys_reader ou uma das funções de membro.

Para mais informações, consulte Sobre o controle de acesso detalhado e Papéis do sistema de controle de acesso detalhado.

Acessar a interface do Key Visualizer

Acesse a ferramenta Key Visualizer no console do Google Cloud.

Para acessar o Key Visualizer:

  1. Na página do Spanner no Console do Google Cloud, selecione uma instância.

  2. Selecione um banco de dados para investigar.

  3. No menu de navegação, em Observability, selecione Key Visualizer.

Desativar o Key Visualizer

O Key Visualizer é controlado pela opção de banco de dados enable_key_visualizer. O valor padrão é true.

Para desativar o Key Visualizer, defina o valor da opção de banco de dados enable_key_visualizer como false. A sintaxe DDL para desativar o Key Visualizer é:

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

Se o ID do banco de dados contém caracteres que não sejam letras, números ou sublinhados, inclua o crase (``).

A instrução pode ser enviada usando um comando gcloud ou em uma solicitação gRPC/REST UpdateDatabaseDdl. Exemplo:

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

Depois de definir explicitamente o valor de enable_key_visualizer, verifique o valor dele clicando em SHOW EQUIVALENT DDL na página de visão geral ou usando o gcloud ddl describe. comando:

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

Reativar o Key Visualizer

Para reativar o Key Visualizer, siga as instruções anteriores, definindo o valor da opção de banco de dados enable_key_visualizer como true.

Quando reativado para um banco de dados pela primeira vez, o mapa de calor do Key Visualizer fica vazio pelos primeiros minutos enquanto o Spanner coleta métricas.

A seguir