Esta página descreve como monitorar e solucionar problemas de consultas executadas na sua instância do Spanner. Consultas ativas são consultas de longa duração que podem afetar o desempenho da sua instância. O monitoramento dessas consultas pode ajudar a identificar as causas de latência da instância e alto uso da CPU.
Com o console do Google Cloud, é possível conferir as consultas ativas na página Insights de consulta do Spanner. Essas consultas são classificadas pelo horário de início da consulta. Se houver muitas consultas ativas, os resultados poderão ser limitados a um subconjunto do total de consultas devido às restrições de memória que o Spanner impõe na coleta de dados.
Antes de começar
Para receber as permissões necessárias para visualizar consultas ativas, peça ao administrador para conceder a você os seguintes papéis do IAM na instância:
-
Leitor do Cloud Spanner (
roles/spanner.viewer) -
Leitor de banco de dados do Cloud Spanner (
roles/spanner.databaseReader)
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias por meio de papéis personalizados ou de outros papéis predefinidos.
Ver consultas ativas
Para conferir as consultas ativas de cada banco de dados, faça o seguinte:
No console do Google Cloud, acesse a página Instâncias do Spanner.
Clique na instância que contém as consultas que você quer monitorar.
No menu de navegação, clique em Query Insights.
Use o menu Banco de dados para especificar o banco de dados que você quer monitorar.
Clique na guia Consultas ativas. A guia contém um resumo das consultas ativas e uma tabela com as 50 consultas ativas mais longas.
Conferir as consultas que estão em execução há mais tempo
A tabela a seguir descreve as colunas na tabela Consultas em execução mais longas na guia Consultas ativas:
| Nome da coluna | Descrição |
|---|---|
| ID da consulta | O identificador exclusivo da consulta. |
| Consulta | O texto da consulta SQL. |
| Impressão digital | O hash do REQUEST_TAG ou do texto da consulta SQL. |
| Horário de início | O carimbo de data/hora de quando a consulta começou. |
| Duração da consulta | A duração da execução da consulta ativa. |
| Ação | Contém um link para encerrar a consulta. |
Quando a opção Atualizar automaticamente está ativada, a tela é atualizada a cada 60 segundos.
Encerrar uma consulta
É possível encerrar uma consulta que está sendo executada na sua instância. A interrupção de uma consulta pode ajudar a liberar recursos e reduzir a carga na sua instância. A interrupção de uma consulta é uma operação de melhor esforço.
A página do console do Google Cloud é atualizada depois que você inicia o encerramento. Se o encerramento for bem-sucedido, a consulta será removida da tabela. Se o encerramento falhar, ele será feito em segundo plano, e a consulta continuará aparecendo na tabela Consultas em execução mais longas.
O Spanner pode não cancelar uma consulta quando os servidores estão ocupados. Você pode tentar encerrar uma consulta novamente para cancelá-la.
Para receber a permissão necessária para encerrar uma consulta,
peça ao administrador para conceder a você o papel do IAM de
Leitor do banco de dados do Cloud Spanner (spanner.databaseReader)
na instância.
Esse papel predefinido contém a
permissão
spanner.sessions.delete,
que é necessária para
encerrar uma consulta.
Para encerrar uma consulta, faça o seguinte:
- Selecione a consulta que você quer encerrar na tabela Consultas em execução mais longas.
- Na coluna Ações, clique em Encerrar.
- Na janela Encerrar consulta, clique em Confirmar.
A seguir
- Saiba mais sobre analisar o desempenho da consulta.
- Saiba mais sobre as estatísticas das consultas ativas mais antigas.