Usar insights de consulta para melhorar o desempenho da consulta

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Esta página descreve como usar o painel de insights de consulta para detectar e analisar problemas de desempenho com suas consultas.

Introdução

O Query Insights ajuda a detectar, diagnosticar e evitar problemas de desempenho relacionados aos bancos de dados do Cloud SQL. Ele é compatível com monitoramento intuitivo e fornece informações de diagnóstico que ajudam você a ir além da detecção para identificar a causa raiz de problemas de desempenho.

O Query insights ajuda a melhorar o desempenho de consulta do Cloud SQL, orientando você pelas seguintes etapas:

• Conferir a carga do banco de dados das consultas mais frequentes
• Identificar uma consulta potencialmente problemática

Consultar insights para a edição do Cloud SQL Enterprise Plus

Se você estiver usando o Cloud SQL edição Enterprise Plus, poderá acessar outros recursos nos insights de consulta para realizar diagnósticos avançados de desempenho de consulta. Além dos recursos padrão do painel de insights de consulta, os insights de consulta para a edição Enterprise Plus do Cloud SQL permitem:

• Capture textos de consulta mais longos, com até 20 KB.
• Capture planos de consulta para todas as consultas executadas.
• Amostre até 200 planos de consulta por minuto.
• Mantenha uma retenção de métricas de 30 dias.
• Receber recomendações de índice do consultor de índice.
• Encerrar uma sessão ou transação de longa duração em consultas ativas.

A tabela a seguir compara os requisitos funcionais e os recursos dos insights de consulta do Cloud SQL Enterprise com os do Cloud SQL Enterprise Plus.

Ativar os insights de consulta para o Cloud SQL Enterprise Plus

Para ativar os insights de consulta na edição do Cloud SQL Enterprise Plus, selecione Ativar recursos do Enterprise Plus ao Ativar insights de consulta na sua instância do Cloud SQL Enterprise Plus.

Preços

Não há custo adicional para insights de consulta nas instâncias do Cloud SQL Enterprise Edition ou do Cloud SQL Enterprise Plus.

Requisitos de armazenamento

Os insights de consulta armazenam dados de métricas na instância e exigem que você mantenha a configuração de aumento automático de armazenamento ativada. Sujeito a taxas de armazenamento aplicáveis.

Antes de começar

Antes de usar os insights de consulta, faça o seguinte:

1. Adicione papéis e permissões necessários.
2. Ative a API Cloud Trace.
3. Se você estiver usando insights de consulta para a edição Cloud SQL Enterprise ou para a edição Cloud SQL Enterprise Plus, verifique se a opção Ativar aumentos automáticos de armazenamento está ativada para a instância.

Papéis e permissões necessárias

Para usar os insights de consulta, é necessário conceder um papel predefinido, criar um papel personalizado ou fornecer a uma conta de usuário as permissões necessárias do Identity and Access Management.

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Para receber as permissões necessárias para acessar dados históricos de execução de consultas no painel de insights de consulta, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto que hospeda a instância do Cloud SQL:

• Leitor de monitoramento de insights do banco de dados (roles/databaseinsights.monitoringViewer)
• Leitor do Cloud SQL (roles/cloudsql.viewer)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para acessar dados históricos de execução de consultas no painel de insights de consultas. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

• Editor do Cloud SQL (roles/cloudsql.editor)
• Administrador do Cloud SQL (roles/cloudsql.admin)

Ativar a API Trace

Para conferir os planos de consulta e as visualizações completas, seu projeto Google Cloud precisa ter a API Trace ativada. Essa configuração permite que o projeto do Google Cloud receba dados de trace de fontes autenticadas sem custos adicionais. Esses dados podem ajudar a detectar e diagnosticar problemas de desempenho na instância.

Para confirmar se a API Trace está ativada, siga estas etapas:

1. No console do Google Cloud, acesse APIs e serviços:

   Acessar APIs e Serviços

2. Clique em Ativar APIs e serviços.
3. Na barra de pesquisa, digite Trace API.
4. Se a mensagem API ativada for exibida, isso significa que a API está ativada e não há nada para fazer. Caso contrário, clique em Ativar.

Ativar aumento automático de armazenamento

Se você estiver usando insights de consulta para o Cloud SQL Enterprise Plus, verifique se a configuração de instância para ativar o crescimento automático de armazenamento permanece ativada. Por padrão, essa opção é ativada para instâncias do Cloud SQL.

Se você desativou essa configuração de instância e quer ativar os insights de consulta para o Cloud SQL edição Enterprise Plus, reative o aumento automático de armazenamento primeiro. Não é possível desativar os aumentos automáticos de armazenamento e ativar os insights de consulta para a edição Cloud SQL Enterprise Plus.

Ativar o Query Insights

Quando você ativa os insights de consulta, todas as outras operações são temporariamente suspensas. Essas operações incluem verificações de integridade, geração de registros, monitoramento e outras operações da instância.

    gcloud sql instances patch INSTANCE_ID \
    --insights-config-query-insights-enabled
  

gcloud sql instances patch INSTANCE_ID \
--insights-config-query-insights-enabled \
--insights-config-query-string-length=INSIGHTS_CONFIG_QUERY_STRING_LENGTH \
--query_plans_per_minute=QUERY_PLANS_PER_MINUTE \
--tier=API_TIER_STRING \
--region=REGION
  

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

{
  "settings" : {
     "insightsConfig" : {
       "queryInsightsEnabled" : true,
       "recordClientAddress" : true,
       "queryStringLength" : 1024,
       "queryPlansPerMinute" : 20,
   }
  }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2025-03-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

As métricas devem ser disponibilizadas nos insights de consulta alguns minutos após a conclusão da consulta.

Visualizar o painel do Query insights

O painel do Query insights mostra a carga de consulta com base nos fatores selecionados. A carga de consulta é a medida do trabalho total de todas as consultas na instância no intervalo de tempo selecionado. O painel fornece uma série de filtros que ajudam você a visualizar a carga de consulta.

Para abrir o painel Insights de consulta, siga estas etapas:

1. Para abrir a página Visão geral de uma instância, clique no nome da instância.
2. No menu de navegação do Cloud SQL, clique em Query Insights ou em Acessar Query Insights para mais informações detalhadas sobre consultas e desempenho na página Visão geral da instância.

O painel Insights da consulta é aberto. Dependendo se você está usando insights de consulta para a edição do Cloud SQL Enterprise ou para a edição do Cloud SQL Enterprise Plus, o painel de insights de consulta mostra as seguintes informações sobre sua instância:

• Bancos de dados: filtra a carga de consulta em um banco de dados específico ou em todos os bancos de dados.
• Intervalo de tempo: filtra a carga da consulta por períodos, como 1 hora, 6 horas, 1 dia, 7 dias, 30 dias ou um intervalo personalizado.
• Gráfico de carga do banco de dados: exibe o gráfico de carga de consulta com base nos dados filtrados.
• Consultas e bancos de dados: filtra a carga de consulta por uma consulta ou um banco de dados selecionado. Consulte Filtrar a carga do banco de dados.

Visualizar a carga do banco de dados de todas as consultas

A carga de consulta do banco de dados é uma medida do trabalho (em segundos de CPU) que as consultas executadas no banco de dados selecionado realizam ao longo do tempo. Cada consulta em execução está usando ou aguardando recursos de CPU, recursos de E/S ou recursos de bloqueio. A carga de consulta do banco de dados é a proporção entre o tempo gasto por todas as consultas concluídas em uma determinada janela de tempo e o tempo real decorrido.

O painel de insights sobre consultas de nível superior mostra o gráfico Carga do banco de dados por tempo de execução. Os menus suspensos no painel permitem filtrar o gráfico para todos os bancos de dados ou um banco de dados específico.

As linhas coloridas no gráfico mostram a carga do banco de dados por tempo de execução. Analise o gráfico e use as opções de filtragem para analisar estas perguntas:

• A consulta está alta? O gráfico está aumentando ou se elevando ao longo do tempo? Se você não vê uma carga alta, o problema não está nas consultas.
• Quanto tempo a carga tem sido alta? Ela é alta apenas agora ou tem sido alta por muito tempo? Use o seletor de intervalo para selecionar vários períodos e descobrir quanto tempo durou o problema. Aumente o zoom para conferir uma janela de tempo em que os picos de carga de consulta são observados. Diminua o zoom para conferir até uma semana na linha do tempo.
• Qual banco de dados está passando pela carga? Selecione diferentes bancos de dados no menu suspenso "Bancos de dados" para encontrar os bancos de dados com as cargas mais altas.

Filtrar a carga do banco de dados

• Todas as consultas

• Bancos de dados

Para personalizar o gráfico de carga do banco de dados, selecione uma dimensão no menu suspenso Carga do banco de dados por tempo de execução.

Conferir os principais contribuintes para a carga do banco de dados

Para conferir os principais contribuintes para a carga do banco de dados, use a tabela Principais dimensões por carga do banco de dados. A tabela Principais dimensões por carga do banco de dados mostra os principais colaboradores para o período e a dimensão selecionados no menu suspenso Carga do banco de dados por tempo de execução. É possível modificar o período ou a dimensão para conferir os principais colaboradores de outra dimensão ou período.

Na tabela Principais dimensões por carga de dados, é possível selecionar as seguintes guias.

Filtrar por consultas

A tabela Consultas principais fornece uma visão geral das consultas que geram a maior parte da carga. A tabela mostra todas as consultas normalizadas para o período e as opções selecionadas no painel de insights da consulta. Ela classifica as consultas pelo tempo total de execução durante o período selecionado.

Para classificar a tabela, selecione um cabeçalho de coluna.

A tabela mostra as seguintes propriedades:

• Consulta: a string de consulta normalizada. Por padrão, os insights de consulta mostram apenas 1.024 caracteres na string de consulta.
• Banco de dados: o banco de dados em que a consulta foi executada.
• Recomendações: as sugestões, como Criar índices, para melhorar o desempenho da consulta.
• Tempo médio de execução (ms): o tempo médio de execução da consulta.
• Tempo total de execução (ms): o tempo total de execução da consulta.
• Horários chamados: o número de vezes que o aplicativo chamou a consulta.
• Média de linhas retornadas: o número médio de linhas retornadas para a consulta.

O Query insights armazena e exibe apenas consultas normalizadas.

Examinar operações em um plano de consulta de amostra

Um plano de consulta usa uma amostra da sua consulta e a divide em operações individuais. Ela explica e analisa cada operação na consulta.

O gráfico Amostras do plano de consulta mostra todos os planos de consulta sendo executados em momentos específicos e o tempo de execução de cada plano. É possível mudar a taxa em que as amostras do plano de consulta são capturadas por minuto. Consulte Ativar o Query Insights.

Por padrão, o painel à direita mostra os detalhes do plano de consulta de amostra que leva mais tempo, conforme exibido no gráfico Amostras do Query insights. Para ver os detalhes de outro plano de consulta de amostra, clique no círculo relevante no gráfico. Os detalhes expandidos mostram um modelo de todas as operações no plano de consulta.

Cada operação mostra as linhas retornadas e, se disponível, o custo da operação. Use a visualização em tela cheia ou a guia De ponta a ponta para conferir as estatísticas de execução estimadas de cada nó (operação), bem como as estatísticas de execução do ambiente de execução associadas ao nó raiz.

Para restringir o problema, observe o seguinte:

1. Qual é o consumo de recursos?
2. Como ele se relaciona com outras consultas?
3. O consumo muda com o tempo?

Recurso de detalhes da consulta

Os detalhes da consulta podem fornecer mais detalhes sobre uma consulta específica, incluindo o tempo médio de execução, o número de chamadas e o número médio de linhas retornadas. Ele também pode oferecer recomendações, como índices, para melhorar a performance da consulta.

Os detalhes da consulta também fornecem as seguintes métricas:

• Exemplos de plano de consulta: esses exemplos ajudam a explicar e analisar sua consulta, fornecendo um detalhamento das diferentes operações em uma amostra da consulta.

  

• Contagem de execuções de consulta ao longo do tempo: mostra o número de vezes que a consulta foi concluída em um período especificado. O gráfico ajuda a entender melhor quando uma consulta geralmente é executada e pode ajudar a estimar o impacto da consulta na performance da instância.

  

• Linhas médias retornadas ao longo do tempo: mostra o número médio de linhas retornadas pela consulta ao longo do tempo. Esses dados podem ajudar a correlacionar consultas mais lentas que o normal com uma quantidade maior de dados retornados por essas consultas.

  

• Estatísticas de E/S: mostra as estatísticas de entrada e saída da consulta, incluindo os seguintes filtros:
  • Média de leituras lógicas
  • Média de leituras físicas
  • Média de gravações lógicas

  É possível usar métricas de E/S para correlacionar consultas mais lentas que o normal com um uso de E/S mais intenso ou mudanças nos padrões de E/S.

  Por exemplo, se o número de leituras lógicas aumentar, isso pode ser uma indicação de que a consulta começou a ler mais dados do que o normal. Se o número de leituras físicas aumentar, isso poderá indicar que o Cloud SQL começou a ler mais dados do disco, e não do buffer cache. Por exemplo, talvez não houvesse memória suficiente para armazenar todos os dados em cache ou a instância começou a ler muitos dados. Se o número de gravações lógicas aumentar, isso pode indicar que a consulta começou a gravar mais dados no disco de dados.

  Este é um exemplo de como essa métrica pode ajudar a medir o impacto da consulta na E/S da instância.

  

• Estatísticas de memória: mostra as estatísticas de uso de memória da consulta, incluindo os seguintes filtros:
  • Média de memória ideal
  • Média de memória reservada
  • Média de memória usada

  Essa métrica pode ajudar a detectar mudanças no consumo de memória relacionadas à consulta, incluindo os seguintes exemplos:

  • Use essa métrica para detectar quando o Cloud SQL previu incorretamente a quantidade de memória necessária para executar a consulta e pode ter reservado mais memória do que a usada pela consulta.
  • Use essa métrica para detectar quando o Cloud SQL não conseguiu alocar memória suficiente e reservou uma concessão de memória menor. Quando isso acontece, o Cloud SQL usa o banco de dados tempdb, que é mais lento do que usar a memória.
  • Use a métrica com o número de execuções de consulta para medir o impacto da consulta no consumo de memória da instância.
  • Use a métrica quando houver alto uso ou pressão da memória.

  

• Estatísticas de CPU e tempo de execução: mostra uma visualização combinada das estatísticas de tempo de CPU e de tempo de execução da consulta. É possível usar a métrica de tempo da CPU para investigar o alto uso da CPU na instância, incluindo os seguintes exemplos:
  • É possível usar uma combinação de métricas de tempo de CPU e contagem de execuções para medir o impacto da consulta no consumo total de CPU na instância.
  • É possível usar uma combinação de tempo de CPU, tempo de execução e métricas de paralelismo para medir a porcentagem de tempo que a consulta esperou por recursos.
  • É possível usar a métrica de tempo de execução para detectar quando uma consulta demorou mais para ser executada do que o normal.

  

• Outras estatísticas de consulta: mostra outras estatísticas relacionadas à consulta, incluindo os seguintes filtros:
  • Estatísticas do ambiente de execução de linguagem comum (CLR)
  • Estatísticas do columnstore
  • Vazamentos de memória
  • Estatísticas de paralelismo

  

Desativar insights de consulta

gcloud sql instances patch INSTANCE_ID \
  --no-insights-config-query-insights-enabled

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

{
  "settings" : { "insightsConfig" : { "queryInsightsEnabled" : false } }
}

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2021-01-28T22:43:40.009Z",
  "operationType": "UPDATE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Desativar os insights de consulta para o Cloud SQL Enterprise Plus

Para desativar os insights de consulta na edição Enterprise Plus do Cloud SQL, faça o seguinte:

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse Instâncias do Cloud SQL

2. Para abrir a página Visão geral de uma instância, clique no nome dela.
3. Clique em Editar.
4. Na seção Personalizar sua instância, abra Insights de consulta.
5. Desmarque a caixa de seleção Ativar recursos da edição Enterprise Plus.
6. Clique em Salvar.

A seguir

• Blog de lançamento: Solução de gargalos do banco de dados mais rápida com os insights de consulta mais recentes do Cloud SQL Enterprise Plus
• Blog: Melhore suas habilidades de solução de problemas de desempenho das consultas com o Cloud SQL Insights
• Vídeo: Introdução ao Cloud SQL Insights
• Podcast: Insights do Cloud SQL
• Codelab do Insights
• Otimizar o alto uso da CPU
• Otimizar o alto uso da memória