Usar o consultor de índice com o Query Insights

MySQL   |  PostgreSQL   |  SQL Server

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Importante: o consultor de índice só estará disponível se você tiver ativado o Gemini em bancos de dados. Para mais informações sobre como ativar o Gemini nos bancos de dados, consulte Configurar a Central do banco de dados.

Nesta página, descrevemos como usar o consultor de índice do Cloud SQL para PostgreSQL com o Query Insights.

Use o consultor de índice com o Query Insights para ver as recomendações dele e criar índices recomendados para melhorar o desempenho da consulta. Para saber mais sobre o consultor de índice, consulte Visão geral do consultor de índice. Para saber como usar o consultor de índice para ver e consultar recomendações como uma tabela ou solicitar uma análise e um relatório sob demanda, consulte Usar o consultor de índice.

Antes de começar

1. Configure o Gemini.

2. Para usar o Query Insights, é preciso ter permissões específicas do IAM. Crie um papel personalizado e adicione a permissão cloudtrace.traces.get do IAM a ele. Em seguida, adicione esse papel a cada conta de usuário que precisa usar o Query insights.

3. Para ver os planos de consulta e as visualizações completas, seu projeto do 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. Quando a mensagem API ativada é exibida, isso significa que a API está ativada e nenhuma outra ação é necessária. Caso contrário, clique em Ativar.

Ativar recomendações do consultor de índice

Para ativar as recomendações do consultor de índice, adicione a flag cloudsql.enable_index_advisor à instância do Cloud SQL para PostgreSQL. Para mais informações sobre como adicionar uma flag à instância, consulte Configurar flags do banco de dados.

Ver e filtrar as recomendações do consultor de índice

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 da instância.
3. Clique em Query Insights. As recomendações do consultor de índice são exibidas na coluna Recomendação da seção Consultas e tags mais frequentes.
4. (Opcional) Para ver somente consultas com recomendações CREATE INDEX, adicione um filtro para Recomendação: criar índices.

Ver recomendações para uma consulta

Para ver detalhes das recomendações de índice para uma consulta específica, siga estas etapas:

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 da instância.
3. Clique em Query Insights.
4. Na seção Consultas e tags mais frequentes, clique em Consultas.
5. Para saber os detalhes da recomendação sobre uma consulta, siga um destes procedimentos:
   • Clique em uma consulta para saber mais sobre as recomendações para a consulta selecionada, incluindo as seguintes informações:
     • Impacto no desempenho (alto, médio e baixo): a velocidade de consulta estimada após a criação de todos os índices recomendados.
     • Recomendações: crie recomendações de índice.
     • Tabelas afetadas: o número de tabelas que serão afetadas quando os índices forem criados.
     • Armazenamento estimado adicional necessário: o tamanho de armazenamento estimado necessário para criar todos os índices recomendados.
     • Número de consultas afetadas: o número total de consultas na carga de trabalho afetadas pelas recomendações de índice. Um índice pode beneficiar várias consultas.
   • Clique em Criar índices para uma consulta específica e confira recomendações detalhadas sobre como criar índices para melhorar o desempenho da consulta.

Ver consultas afetadas

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 da instância.
3. Clique em Query Insights.
4. Na tabela Principais dimensões por carga do banco de dados, clique em Consultas.
5. Clique em Criar índices para uma consulta específica.
6. Clique em Mostrar consultas afetadas.
7. Clique em uma consulta para ver os detalhes da consulta afetada.

Criar índices recomendados

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 da instância.
3. Clique em Query Insights.
4. Na tabela Principais dimensões por carga do banco de dados, clique em Consultas.
5. Clique em Criar índices para uma consulta específica.
6. Clique em Copiar todos os comandos de índice. Os comandos CREATE INDEX são copiados para a área de transferência.
7. Conecte-se à instância principal na linha de comando.

8. Para criar os índices recomendados, execute os comandos que foram copiados para a área de transferência, por exemplo:

   CREATE INDEX ON "public"."demo_order" ("customer_id");
   

A seguir

• Saiba como usar o consultor de índice para ver e consultar recomendações como uma tabela ou solicitar uma análise e um relatório sob demanda.
• Saiba mais sobre o consultor de índice