Acesse o Key Visualizer

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

Antes de começar

Para visualizar o Key Visualizer, você precisa da seguinte permissão de gerenciamento de identidade e acesso (IAM):

  • spanner.databases.read

Se você é um usuário de controle de acesso refinado, deve ter acesso a:

  • o papel do sistema spanner_sys_reader ou um dos papéis de membro dele.

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

Acesse a interface do Key Visualizer

Acesse a ferramenta Key Visualizer no console do Google Cloud.

Para acessar o Key Visualizer:

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

  2. Selecione um banco de dados para investigar.

  3. No menu de navegação, em Observabilidade, 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 pela primeira vez para um banco de dados, o mapa de calor do Key Visualizer ficará vazio por alguns minutos enquanto o Spanner coleta métricas.

A seguir