Usar insights de consulta para melhorar o desempenho da consulta

MySQL   |  PostgreSQL   |  SQL Server

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

Introdução

O Query Insights ajuda a detectar, diagnosticar e evitar problemas de desempenho de consultas em 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:

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

Observação:por padrão, os insights de consulta mostram dados apenas de consultas concluídas, a menos que você esteja monitorando consultas ativas. Para monitorar todas as consultas em execução em tempo real, use consultas ativas. Para mais informações sobre consultas ativas, consulte Monitorar consultas ativas.

Insights de consultas para o Cloud SQL Enterprise Plus

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

• Capture textos de consulta mais longos, de até 20 KB.
• Capture planos de consulta para todas as consultas executadas.
• Faça amostragem de até 200 planos de consulta por minuto.
• Manter uma retenção de métricas por mais tempo, de 30 dias.
• Receba recomendações de índice do consultor de índice.
• Encerre uma sessão ou transação de longa duração em consultas ativas.
• Acesse a solução de problemas assistida por IA (prévia).

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

Área de comparação	Insights de consulta para a edição Enterprise do Cloud SQL	Insights de consultas para o Cloud SQL Enterprise Plus
Versões de banco de dados compatíveis	Todas as versões das seguintes instâncias: SQL Server Web SQL Server Standard SQL Server Enterprise O Query Insights não é compatível com instâncias da edição SQL Server Express	SQL Server Enterprise versão 2019 ou 2022
Tipos de máquina compatíveis	Compatível com todos os tipos de máquinas	Não é compatível com instâncias que usam um tipo de máquina com núcleo compartilhado
Regiões compatíveis	Locais regionais do Cloud SQL	Locais regionais da edição Cloud SQL Enterprise Plus
Período de retenção de métricas	7 dias	30 dias
Limite máximo de tamanho da consulta	4.500 bytes	20 KB
Máximo de amostras de plano de consulta	Indisponível	200
Recomendações do Consultor de índice	Indisponível	Disponível.
Encerrar sessões ou transações de longa duração em consultas ativas	Indisponível	Disponível.
Solução de problemas com a ajuda da IA (pré-lançamento)	Indisponível	Disponível.

Ativar o Query Insights para o Cloud SQL Enterprise Plus

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

Preços

É possível criar uma conta para avaliar o desempenho do Cloud SQL em cenários reais. Novos clientes também recebem US $300 em créditos para gastar no Cloud SQL e executar, testar e implantar cargas de trabalho. Não vai haver cobrança a menos que você faça um upgrade.

Inscreva-se para testar o Cloud SQL sem custos financeiros.

Não há custo adicional para insights de consultas em instâncias do Cloud SQL Enterprise 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 aumentos automáticos de armazenamento ativada. Sujeito a taxas de armazenamento aplicáveis.

Limitações de armazenamento de métricas

As seguintes limitações se aplicam aos insights de consultas para instâncias da edição Cloud SQL Enterprise Plus:

• Se a instância estiver passando por uma carga pesada do sistema, as consultas de dados de métricas no painel Insights de consulta poderão demorar para carregar ou expirar.
• Se você recriar uma réplica de leitura, ela não vai manter o histórico de métricas anterior.
• Se você restaurar uma instância com um backup antigo, poderá perder as métricas entre o momento do backup e o momento em que a instância é restaurada para o Query Insights da edição Cloud SQL Enterprise Plus. Por exemplo, se você restaurar sua instância em 30 de abril com um backup feito em 25 de abril, poderá perder todas as métricas entre 25 e 30 de abril.

Antes de começar

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

1. Adicione os papéis e as permissões necessárias.
2. Ative a API Cloud Trace.
3. Se você estiver usando o Query Insights para o Cloud SQL Enterprise ou o Query Insights para 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 consultas, conceda um papel predefinido, crie um papel personalizado ou forneça uma conta de usuário com as permissões necessárias do Identity and Access Management.

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

Para ter as permissões necessárias para acessar dados históricos de execução de consultas no painel "Insights de consultas", 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 do monitoramento do Database Insights (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 "Insights de consulta". Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para acessar dados históricos de execução de consultas no painel do Query Insights:

• databaseinsights.aggregatedStats.query
• databaseinsights.timeSeries.query

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

Por exemplo, no Database Insights, peça ao administrador para conceder a você o papel predefinido Leitor do Database Insights (roles/databaseinsights.viewer). Em seguida, no Cloud SQL, peça ao administrador para conceder um dos seguintes papéis predefinidos:

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

Ative a API Cloud Trace

Para ver os planos de consulta e as visualizações completas, seu Google Cloud projeto precisa ter a API Cloud 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 Cloud Trace está ativada, siga estas etapas:

1. No console 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 Cloud Trace API.
4. Se a mensagem API ativada for exibida, isso significa que ela está ativada e não há ações adicionais. Caso contrário, clique em Ativar.

Ativar aumento automático de armazenamento

Se você estiver usando o Query Insights para a edição Cloud SQL Enterprise Plus, verifique se a configuração da instância para ativar o aumento automático de armazenamento permanece ativada. Por padrão, essa opção está ativada para instâncias do Cloud SQL.

Se você desativou essa configuração de instância e quer ativar os insights de consultas 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 ativar os insights de consultas para a edição Enterprise Plus do Cloud SQL.

Ativar o Query Insights

Observação:as métricas do Query insights são criptografadas em repouso.

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

Console

Observação: se o Query Insights não estiver ativado em nenhuma das instâncias, clique em Ativar para ativá-lo. Também é possível clicar em Ativar para várias instâncias no painel do Query Insights.

Ativar o Query Insights para uma instância

1. No console 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. No bloco Configuração, clique em Editar configuração.
4. Na seção Personalizar sua instância, expanda Insights de consulta.
5. Marque a caixa de seleção Ativar Query insights.
6. Opcional: selecione outros recursos para sua instância. Alguns recursos estão disponíveis apenas para a edição Enterprise Plus do Cloud SQL.

Recurso	Descrição	Edição Enterprise do Cloud SQL	Edição do Cloud SQL Enterprise Plus
Ativar recursos do Enterprise Plus	Marque essa caixa de seleção para ativar os insights de consultas para a edição Enterprise Plus do Cloud SQL. Com os insights de consulta para a edição Cloud SQL Enterprise Plus, você pode encerrar sessões e transações de longa duração em consultas ativas, ativar as recomendações do consultor de índice para ajudar a acelerar o processamento de consultas e aumentar a retenção de dados de métricas para 30 dias. As recomendações do consultor de índice são ativadas automaticamente quando você ativa os insights de consulta para o Cloud SQL Enterprise Plus. Para desativar as recomendações do consultor de índice, desmarque a caixa de seleção. Marque essa caixa de seleção para ativar as recomendações do consultor de índices e a solução de problemas com a ajuda da IA (pré-lançamento).	Indisponível	Disponível Padrão: desativado
Solução de problemas assistida por IA	Marque essa caixa de seleção para ativar a detecção de anomalias de desempenho, a análise de causa raiz e de situação e receber recomendações para corrigir problemas com suas consultas e seu banco de dados. Esse recurso está em pré-lançamento, e só é possível ativá-lo e acessá-lo usando o console Google Cloud . Para mais informações, consulte Observar e resolver problemas com a assistência de IA.	Indisponível	Disponível Padrão: desativado
Personalizar o tamanho da consulta	Marque essa caixa de seleção para personalizar o limite do comprimento de uma string de consulta. Comprimentos de consulta mais altos são mais úteis para consultas analíticas, mas também exigem mais memória. Qualquer string de consulta que exceda o limite especificado será truncada na exibição. Se você mudar o limite de tamanho da consulta, será necessário reiniciar a instância.	É possível definir o limite em bytes de 256 bytes a 4500 bytes. Padrão: 1024.	É possível especificar um limite em bytes de 256 a 20480. Padrão: 10240 bytes (10 KB).
Definir a taxa de amostragem máxima	Marque essa caixa de seleção para definir a taxa de amostragem máxima. A taxa de amostragem é o número de amostras de planos de consulta executadas que são capturadas por minuto em todos os bancos de dados na instância. Aumentar a taxa de amostragem pode oferecer mais pontos de dados, mas pode aumentar a sobrecarga de desempenho.	Mude esse valor para um número de 0 a 20. Padrão: 5.	É possível aumentar o máximo para 200 e fornecer mais pontos de dados. Padrão: 5.

7. Clique em Salvar.

Ativar insights de consulta para várias instâncias

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

   Acesse "Instâncias do Cloud SQL"

2. Clique no menu Mais ações em qualquer linha.
3. Selecione Ativar o Query Insights.
4. Na caixa de diálogo, marque a caixa de seleção Ativar o Query Insights para várias instâncias.
5. Clique em Ativar.
6. Na caixa de diálogo seguinte, selecione as instâncias para as quais você quer ativar os insights de consulta.
7. Clique em Ativar o Query Insights.
   Observação:se você ativar o Query Insights para várias instâncias, a configuração delas será baseada nas configurações padrão.

gcloud

Para ativar o Query insights em uma instância do Cloud SQL usando gcloud, execute gcloud sql instances patch com a flag --insights-config-query-insights-enabled da seguinte maneira, depois de substituir INSTANCE_ID pelo ID da instância.

Se você ativar os insights de consulta para uma instância do Cloud SQL Enterprise Plus, as recomendações do consultor de índice serão ativadas automaticamente.

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

Além disso, use uma ou mais das seguintes flags opcionais:

• --insights-config-query-string-length

  Define o limite de tamanho da consulta padrão. Comprimentos de consulta mais altos são mais úteis para consultas analíticas, mas também exigem mais memória. Se você mudar o tamanho da consulta, será necessário reiniciar a instância. Para a edição Cloud SQL Enterprise, é possível especificar um valor em bytes de 256 a 4500. O tamanho de consulta padrão é 1024 bytes. Para o Cloud SQL Enterprise Plus, é possível especificar um limite em bytes de 256 a 20480. O valor padrão é 10240 bytes (10 KB).

• --query_plans_per_minute

  Por padrão, no máximo cinco amostras de planos de consulta executadas são capturadas por minuto em todos os bancos de dados na instância. É provável que o aumento da taxa de amostragem ofereça mais pontos de dados, mas pode adicionar uma sobrecarga de desempenho. Para desativar a amostragem, defina esse valor como 0. Para a edição Cloud SQL Enterprise, é possível mudar o valor de 0 para 20. Para a edição Enterprise Plus do Cloud SQL, é possível aumentar o máximo para até 200 e fornecer mais pontos de dados.

Substitua:

• INSIGHTS_CONFIG_QUERY_STRING_LENGTH: o tamanho da string de consulta a ser armazenado em bytes.
• API_TIER_STRING: a configuração de instância personalizada a ser usada na instância.
• REGION: a região da instância.

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
  

REST v1

Para ativar o Query insights em uma instância do Cloud SQL usando a API REST, chame o método instances.patch com as configurações insightsConfig.

Se você ativar os insights de consulta para uma instância do Cloud SQL Enterprise Plus, as recomendações do consultor de índice serão ativadas automaticamente.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID: o ID do projeto
• INSTANCE_ID: o ID da instância

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "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"
}

Terraform

Se quiser usar o Terraform para ativar o Query Insights em uma instância do Cloud SQL, defina a flag query_insights_enabled como true.

Se você ativar os insights de consulta para uma instância do Cloud SQL Enterprise Plus, as recomendações do consultor de índice serão ativadas automaticamente.

Além disso, é possível usar uma ou mais das seguintes flags opcionais:

• query_string_length: para a edição do Cloud SQL Enterprise, é possível especificar um valor em bytes de 256 a 4500. O tamanho de consulta padrão é 1024 bytes. Para o Cloud SQL Enterprise Plus, é possível especificar um limite em bytes de 256 a 20480. O valor padrão é 10240 bytes (10 KB).
• record_client_address: defina o valor como true se quiser gravar o endereço IP do cliente. O padrão é false.
• query_plans_per_minute: para a edição Enterprise do Cloud SQL, é possível definir o valor de 0 para 20. O padrão é 5. Para a edição Enterprise Plus do Cloud SQL, é possível aumentar o máximo até 200 para fornecer mais pontos de dados.

Veja um exemplo:

Para aplicar a configuração do Terraform em um projeto Google Cloud , siga as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o projeto Google Cloud padrão em que você quer aplicar as configurações do Terraform.

   Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.

1. No Cloud Shell, crie um diretório e um novo arquivo dentro dele. O nome do arquivo precisa ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o arquivo é chamado de main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.

   Copie o exemplo de código no main.tf recém-criado.

   Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve as alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade:

   terraform init -upgrade

Aplique as alterações

1. Revise a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expectativas:

   terraform plan

   Faça as correções necessárias na configuração.

2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Apply complete!".

3. Abra seu Google Cloud projeto para ver os resultados. No console Google Cloud , navegue até seus recursos na UI para verificar se foram criados ou atualizados pelo Terraform.

Observação:as amostras do Terraform geralmente presumem que as APIs necessárias estejam ativadas no seu projeto Google Cloud .

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 clique em Acessar o Query Insights para ver informações mais detalhadas sobre consultas e desempenho na página Visão geral da instância.

O painel Insights de consulta é aberto. Dependendo se você está usando o painel de insights de consultas para o Cloud SQL Enterprise ou para o Cloud SQL Enterprise Plus, ele 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 da carga do banco de dados: exibe o gráfico da 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.

Observação: a política de retenção de dados para métricas de consulta é de 7 dias para o Query Insights da edição Cloud SQL Enterprise e de 30 dias para o Query Insights da edição Cloud SQL Enterprise Plus.

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 específico.

As linhas coloridas no gráfico mostram a carga por 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á piscando ou aumentando 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 o problema durou. Aumente o zoom para ver uma janela de tempo em que os picos de carga de consulta são observados. Diminua o zoom para ver 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

É possível filtrar a carga do banco de dados por consultas. Se você estiver usando os insights de consulta para a edição Cloud SQL Enterprise Plus, poderá personalizar o gráfico de carga do banco de dados para detalhar os dados mostrados usando qualquer uma das seguintes dimensões:

• 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.

Ver os principais colaboradores da carga do banco de dados

Para conferir os principais colaboradores da 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 do período e da dimensão selecionados no menu suspenso do gráfico Carga do banco de dados por tempo de execução. É possível modificar o período ou a dimensão para ver os principais colaboradores de outra dimensão ou período.

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

Tab	Descrição
Consultas	A tabela mostra as principais consultas normalizadas por tempo total de execução. Para cada consulta, os dados mostrados nas colunas são listados da seguinte forma: Tempo médio de execução (ms): tempo médio de execução da consulta. Tempo total de execução (ms): o tempo total de execução da consulta específica. Média de linhas retornadas: a média de linhas buscadas para a consulta. Horários chamados: o número de vezes que a consulta foi chamada pelo aplicativo.
Bancos de dados	A tabela mostra a lista dos principais bancos de dados que contribuíram para a carga durante o período escolhido em todas as consultas executadas. Tempo médio gasto no banco de dados (ms): tempo médio que as consultas gastaram no banco de dados específico. Tempo total gasto no banco de dados (ms): o tempo total de execução que as consultas gastaram no banco de dados específico.

Filtrar por consultas

A tabela Principais consultas 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 do Query insights. 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 em execução 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), além das estatísticas de execução de tempo 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 informações sobre uma consulta específica, incluindo o tempo médio de execução, o número de vezes que ela foi chamada e o número médio de linhas retornadas. Ele também pode 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: ajudam a explicar e analisar sua consulta, fornecendo um detalhamento das diferentes operações em uma amostra dela.

  

• 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 você a entender melhor quando uma consulta é executada normalmente e pode ajudar a estimar o impacto dela 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 você a correlacionar consultas mais lentas do que o normal com um aumento na quantidade de dados retornados por elas.

  

• Estatísticas de E/S: mostram 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

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

  Por exemplo, se o número de leituras lógicas aumentar, isso pode indicar que a consulta começou a ler mais dados do que o normal. Se o número de leituras físicas aumentar, isso pode indicar que o Cloud SQL começou a ler mais dados do disco em vez do cache de buffer. Por exemplo, talvez não haja memória suficiente para armazenar em cache todos os dados ou a instância começou a ler muitos dados. 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: mostram 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 você 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 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 junto com o número de execuções de consultas para medir o impacto da consulta no consumo de memória da instância.
  • Use a métrica quando você notar alto uso ou pressão da memória.

  

• Estatísticas de CPU e tempo de execução: mostra uma visualização combinada de estatísticas de tempo de CPU e tempo de execução da consulta. É possível 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ções 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.
  • Use a métrica de tempo de execução para detectar quando uma consulta levou mais tempo 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 o Query Insights

Observação: quando você desativa os insights de consulta, o Cloud SQL não exclui nenhum dado do disco.

Console

Para desativar os insights de consulta em uma instância do Cloud SQL usando o console Google Cloud , siga estas etapas:

1. No console 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. No bloco Configuração, clique em Editar configuração.
4. Na seção Opções de configuração, expanda Query insights.
5. Desmarque a caixa de seleção Ativar Query insights.
6. Clique em Save.

gcloud

Para desativar os insights de consulta em uma instância do Cloud SQL usando gcloud, execute gcloud sql instances patch com a flag --no-insights-config-query-insights-enabled da seguinte maneira, depois de substituir INSTANCE_ID pelo ID da instância.

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

REST

Para desativar o Query insights em uma instância do Cloud SQL usando a API REST, chame o método instances.patch com queryInsightsEnabled definido como false.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• project-id: o ID do projeto.
• instance-id: o ID da instância

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

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"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "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 o Query Insights 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 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, expanda Insights de consulta.
5. Desmarque a caixa de seleção Ativar recursos do Enterprise Plus.
6. Clique em Salvar.

Observação: se você desmarcar a caixa de seleção Ativar o Query Insights, também vai desativar o Query Insights para a edição Cloud SQL Enterprise Plus.

A seguir

• Blog de lançamento: Resolva gargalos de banco de dados mais rápido com os insights de consulta mais recentes para a edição 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