Use 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 da consulta para detectar e analisar problemas de desempenho com suas consultas.

Introdução

O Query Insights ajuda a detectar, diagnosticar e prevenir problemas de desempenho de consultas em bancos de dados Cloud SQL. Ele oferece suporte a monitoramento intuitivo e fornece informações de diagnóstico que ajudam você a ir além da detecção e identificar a causa raiz dos problemas de desempenho.

O Query Insights ajuda você a melhorar o desempenho das consultas do Cloud SQL, orientando você nas seguintes etapas:

• Visualizar a carga do banco de dados para as principais consultas
• Identificar uma consulta potencialmente problemática

Insights de consulta para a edição Cloud SQL Enterprise Plus

Se você estiver usando a edição Cloud SQL Enterprise Plus, poderá acessar recursos adicionais no Query Insights para realizar diagnósticos avançados de desempenho de consultas. Além dos recursos padrão do painel Query Insights, o Query Insights para a edição Cloud SQL Enterprise Plus permite que você faça o seguinte:

• Capture textos de consulta mais longos, de até 20 KB.
• Capture planos de consulta para todas as consultas executadas.
• Crie amostras de até 200 planos de consulta por minuto.
• Mantenha uma retenção de métricas mais longa, de 30 dias.
• Obtenha recomendações de índice do consultor de índice.
• Encerra uma sessão ou transação de longa duração em consultas ativas.
• Acesse a solução de problemas assistida por IA ( visualização ).

A tabela a seguir compara os requisitos funcionais e os recursos do Query Insights para a edição Cloud SQL Enterprise com o Query Insights para a edição Cloud SQL Enterprise Plus.

Habilitar insights de consulta para a edição Cloud SQL Enterprise Plus

Para habilitar o query insights para a edição Cloud SQL Enterprise Plus, selecione Habilitar recursos do Enterprise Plus ao Habilitar o query insights na sua instância da edição Cloud SQL Enterprise Plus.

Preços

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

Requisitos de armazenamento

O Query Insights armazena dados de métricas na instância e exige que você mantenha a configuração de aumento automático de armazenamento ativada. Taxas de armazenamento aplicáveis ​​serão aplicadas .

Antes de começar

Antes de usar o query insights, faça o seguinte.

1. Adicione funções e permissões necessárias .
2. Habilite a API do Cloud Trace .
3. Se você estiver usando o Query Insights para a edição Cloud SQL Enterprise ou o Query Insights para a edição Cloud SQL Enterprise Plus, certifique-se de que a opção Habilitar aumentos automáticos de armazenamento esteja habilitada para a instância .

Funções e permissões necessárias

Para usar o query insights, você precisa conceder uma função predefinida, criar uma função personalizada ou fornecer a uma conta de usuário as permissões necessárias de Gerenciamento de Identidade e Acesso.

Para obter mais informações sobre como conceder funções, consulte Gerenciar acesso .

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

• Visualizador de monitoramento do Database Insights ( roles/databaseinsights.monitoringViewer )
• Visualizador do Cloud SQL ( roles/cloudsql.viewer )

Para obter mais informações sobre como conceder funções, consulte Gerenciar acesso a projetos, pastas e organizações .

Essas funções predefinidas contêm as permissões necessárias para acessar dados históricos de execução de consultas no painel de insights da consulta. Para ver as permissões exatas necessárias, expanda a seção Permissões necessárias :

Você também pode obter essas permissões com funções personalizadas ou outras funções predefinidas .

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

Habilitar a API de rastreamento

Para visualizar planos de consulta e suas visualizações de ponta a ponta, seu Google Cloud o projeto deve ter a API Trace habilitada. Esta configuração permite que seuGoogle Cloud O projeto recebe dados de rastreamento de fontes autenticadas sem custo adicional. Esses dados podem ajudar você a detectar e diagnosticar problemas de desempenho na sua instância.

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

1. Do Google Cloud console, vá para APIs e Serviços :

   Acesse APIs e Serviços

2. Clique em Habilitar APIs e serviços .
3. Na barra de pesquisa, digite Trace API .
4. Se a opção API habilitada for exibida, significa que a API está habilitada e não há mais nada a ser feito. Caso contrário, clique em Habilitar .

Habilitar aumentos automáticos de armazenamento

Se você estiver usando o Query Insights para a edição Enterprise Plus do Cloud SQL, certifique-se de que a configuração da instância para habilitar o aumento automático de armazenamento permaneça habilitada. Por padrão, essa opção está habilitada para instâncias do Cloud SQL.

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

Habilitar insights de consulta

Ao habilitar os insights de consulta, todas as outras operações são suspensas temporariamente. Essas operações incluem verificações de integridade, registro em log, monitoramento e outras operações de 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": "[email protected]",
  "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"
}

Espera-se que as métricas estejam disponíveis nos insights da consulta minutos após a conclusão da consulta.

Exibir o painel de insights da consulta

O painel de insights da consulta mostra a carga da consulta com base nos fatores selecionados. A carga da consulta é uma mensuração 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 a visualizar a carga da consulta.

Para abrir o painel de insights da 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 Insights da consulta ou clique em Ir para Insights da consulta para obter informações mais detalhadas sobre consultas e desempenho na página Visão geral da instância .

O painel de insights da consulta é aberto. Dependendo se você estiver usando o Query Insights para a edição Enterprise do Cloud SQL ou o Query Insights para a edição Enterprise Plus do Cloud SQL, o painel de insights da 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 intervalos de tempo, 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 da consulta, com base em dados filtrados.
• Consultas e Bancos de Dados : Filtra a carga da 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 para todas as consultas

A carga de consultas ao 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 consultas ao banco de dados é a razão entre o tempo gasto por todas as consultas concluídas em um determinado intervalo de tempo e o tempo de processamento.

O painel de insights de consulta de nível superior exibe o gráfico de 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 para um banco de dados específico.

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

• A carga da consulta está alta? O gráfico está apresentando picos ou se elevou ao longo do tempo? Se você não observar uma carga alta, o problema não está na sua consulta.
• Há quanto tempo a carga está alta? Ela está alta apenas agora ou já está alta há muito tempo? Use o seletor de intervalo para selecionar vários períodos e descobrir a duração do problema. Aumente o zoom para visualizar uma janela de tempo em que picos de carga de consulta são observados. Diminua o zoom para visualizar até uma semana da linha do tempo.
• Qual banco de dados está com a carga mais alta? 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 .

Veja os principais contribuidores para a carga do banco de dados

Para visualizar os principais contribuidores para a carga do banco de dados, você pode usar a tabela "Principais dimensões por carga do banco de dados" . A tabela "Principais dimensões por carga do banco de dados" exibe os principais contribuidores para o período e a dimensão selecionados no menu suspenso do gráfico "Carga do banco de dados por tempo de execução" . Você pode modificar o período ou a dimensão para visualizar os principais contribuidores para uma dimensão ou período diferente.

Na tabela Principais dimensões por carga de dados , você pode selecionar as seguintes guias.

Filtrar por consultas

A tabela "Principais consultas" fornece uma visão geral das consultas que causam a maior carga de consulta. A tabela mostra todas as consultas normalizadas para o intervalo de tempo e as opções selecionadas no painel "Insights da consulta". Ela classifica as consultas pelo tempo total de execução durante o intervalo de tempo selecionado.

Para classificar a tabela, selecione um título de coluna.

A tabela mostra as seguintes propriedades:

• Consulta : a string de consulta normalizada. Por padrão, o Query Insights exibe apenas 1.024 caracteres na string de consulta.
• Banco de dados : o banco de dados no qual a consulta foi executada.
• Recomendações : as recomendações sugeridas, como Criar índices , para melhorar o desempenho da consulta.
• Tempo médio de execução (ms) : tempo médio de execução da consulta.
• Tempo total de execução (ms) : o tempo total para a consulta ser executada.
• Vezes chamadas : o número de vezes que o aplicativo chamou a consulta.
• Média de linhas retornadas : 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 amostrado

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

O gráfico de amostras de planos de consulta mostra todos os planos de consulta em execução em determinados momentos e o tempo que cada plano levou para ser executado. Você pode alterar a taxa de captura de amostras de planos de consulta por minuto. Consulte Habilitar Insights de Consulta .

Por padrão, o painel à direita mostra os detalhes do plano de consulta de exemplo que leva mais tempo, conforme visível no gráfico " Amostras do plano de consulta" . Para ver os detalhes de outro plano de consulta de exemplo, clique no círculo correspondente 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 o De ponta a ponta guia para ver estatísticas de execução estimadas para cada nó (operação), bem como estatísticas de execução em tempo de execução associadas ao nó raiz.

Tente restringir o problema analisando as seguintes questões:

1. Qual é o consumo de recursos?
2. Como isso 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 tempo médio de execução, número de chamadas e número médio de linhas retornadas. Também podem oferecer recomendações, como índices, para ajudar a melhorar o desempenho 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 uma análise das diferentes operações em um exemplo da consulta.

  

• Contagem de execuções de consultas 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 você a entender melhor quando uma consulta geralmente é executada e pode ajudar a estimar o impacto da consulta no desempenho da instância.

  

• Média de linhas 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 do 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:
  • Leituras lógicas médias
  • Leituras físicas médias
  • Média de gravações lógicas

  Você pode usar métricas de E/S para ajudar a correlacionar consultas mais lentas que o normal com uso mais intensivo de E/S ou alterações nos padrões de E/S.

  Por exemplo, se o número de leituras lógicas aumentou, 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 aumentou, isso pode indicar que o Cloud SQL começou a ler mais dados do disco em vez do cache do buffer. Por exemplo, talvez não houvesse memória suficiente para armazenar todos os dados em cache ou a instância começou a ler dados demais. Se o número de gravações lógicas aumentou, 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 para a consulta, incluindo os seguintes filtros:
  • Memória ideal média
  • Memória média reservada
  • Memória média utilizada

  Essa métrica pode ajudar você a detectar alterações no consumo de memória relacionadas à consulta, incluindo os seguintes exemplos:

  • Use esta 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 esta 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 memória.
  • Use a métrica junto 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 observar alto uso de memória ou pressão de memória.

  

• Estatísticas de CPU e tempo de execução : mostra uma visão combinada das estatísticas de tempo de CPU e tempo de execução da consulta. Você pode usar a métrica de tempo de CPU para investigar o alto uso de CPU na instância, incluindo os seguintes exemplos:
  • Você pode usar uma combinação de métricas de tempo de CPU e contagem de execução para medir o impacto da consulta no consumo total de CPU na instância.
  • Você pode 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 ficou aguardando recursos.
  • Você pode usar a métrica de tempo de execução para detectar quando uma consulta levou mais tempo para ser executada do que o normal.

  

• Estatísticas adicionais de consulta : mostra estatísticas adicionais relacionadas à consulta, incluindo os seguintes filtros:
  • Estatísticas do Common Language Runtime (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": "[email protected]",
  "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"
}

Desabilitar insights de consulta para a edição Cloud SQL Enterprise Plus

Para desabilitar o query insights para a edição Cloud SQL Enterprise Plus, faça o seguinte:

1. No Google Cloud console, 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 da instância.
3. Clique em Editar .
4. Na seção Personalizar sua instância , expanda Insights da consulta .
5. Desmarque a caixa de seleção Habilitar recursos do Enterprise Plus .
6. Clique em Salvar .

O que vem a seguir

• Lançamento do blog: resolva gargalos de banco de dados mais rapidamente com os insights de consulta mais recentes para a edição Cloud SQL Enterprise Plus
• Blog: Aumente suas habilidades de solução de problemas de desempenho de consultas com o Cloud SQL Insights
• Vídeo: Apresentando o Cloud SQL Insights
• Podcast: Insights do Cloud SQL
• Insights Codelab
• Otimizar o alto uso da CPU
• Otimizar alto uso de memória