Aceda ao visualizador de chaves

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

Antes de começar

Para ver o Key Visualizer, precisa da seguinte autorização de gestão de identidade e acesso (IAM):

  • spanner.databases.read

Se for um utilizador do controlo de acesso detalhado, tem de lhe ter sido concedido acesso ao seguinte:

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

Para mais informações, consulte os artigos Acerca do controlo de acesso detalhado e Funções do sistema de controlo de acesso detalhado.

Aceda à interface do Key Visualizer

Aceda à ferramenta Key Visualizer a partir do Google Cloud console.

Para aceder ao visualizador de chaves:

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

  2. Selecione uma base de dados para investigar.

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

Desative o visualizador de teclas

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

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

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

Se o ID da base de dados contiver carateres que não sejam letras, números ou sublinhados, certifique-se de que inclui o ID entre acentos graves (``).

A declaração pode ser enviada através de um comando gcloud ou num pedido UpdateDatabaseDdl gRPC/REST. Por 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, pode verificar o respetivo valor clicando em MOSTRAR LDD EQUIVALENTE na página de vista geral ou usando o comando ddl describe gcloud:

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

Reative o Visualizador de chaves

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

Quando é reativado pela primeira vez para uma base de dados, o mapa de calor do Key Visualizer fica vazio durante os primeiros minutos enquanto o Spanner recolhe métricas.

O que se segue?