Usar o consultor de índice

O AlloyDB para PostgreSQL oferece um consultor de índice que monitora as consultas processadas pelo seu banco de dados. Periodicamente, ele analisa essas consultas para recomendar novos índices que podem aumentar o desempenho das consultas.

É possível trabalhar com as recomendações do consultor de índice das seguintes maneiras:

Para saber mais sobre como o consultor de índice funciona, consulte Visão geral do consultor de índice.

Antes de começar

Antes de usar o consultor de índice, verifique se você atende aos seguintes requisitos.

Ativar as extensões necessárias

  1. No Google Cloud console, acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do Recurso.

  3. Na página Query Insights, clique em Editar configurações de consulta.

  4. Clique em Ativar o consultor de índices.

Ver as recomendações do consultor de índice

O AlloyDB executa de maneira automática e periódica a análise do consultor de índice. É possível ver as recomendações de índice resultantes no painel do Query Insights no console do Google Cloud ou consultando diretamente as visualizações de tabela do banco de dados.

Ver recomendações no Query Insights

O AlloyDB integra o consultor de índices com os insights de consultas e os insights de consultas avançados no console doGoogle Cloud .

Quando o consultor de índices identifica índices de busca vetorial de árvore B ou ScaNN ausentes que podem melhorar o desempenho da consulta, o painel do Query Insights mostra as recomendações e os avisos do consultor de índices nas seguintes visualizações:

  • Na página Query Insights, na seção Principais dimensões por carga do banco de dados, selecione a guia Consultas. Na tabela, a coluna Recomendações exibe um link Criar índices ao lado de qualquer consulta que tenha recomendações do consultor de índice. Também é possível adicionar um filtro para Recomendação: criar índices para ver apenas consultas com recomendações de índice.

  • Ao selecionar uma consulta na tabela Consultas, a página Detalhes da consulta é aberta, mostrando um card de Recomendação de índice na visualização do plano de consulta de amostra e uma tabela de Índices recomendados. Essas visualizações mostram o impacto estimado no desempenho (alto, médio ou baixo), o tipo de índice recomendado e a tabela de destino, o armazenamento extra estimado necessário, o número de tabelas afetadas e o número de consultas afetadas.

  • Clique em Criar índices (ou Ver detalhes em uma recomendação) para abrir o painel Criar índices para melhorar o desempenho da consulta. Nesse painel, é possível inspecionar as instruções DDL CREATE INDEX recomendadas, conferir a melhoria estimada no tempo de execução, clicar em Mostrar consultas afetadas para inspecionar todas as consultas de carga de trabalho que se beneficiam do índice recomendado e copiar os comandos ou abri-los diretamente no AlloyDB Studio.

Para instruções detalhadas sobre como configurar a frequência de atualização de recomendações, filtrar recomendações e criar índices recomendados no console doGoogle Cloud , consulte Usar o consultor de índices do AlloyDB para PostgreSQL com o Query Insights e Melhorar o desempenho de consultas usando os recursos avançados do Query Insights.

Ver recomendações usando visualizações de banco de dados

Também é possível ler os resultados do consultor de índices em duas visualizações de tabela localizadas em cada um dos bancos de dados:

  • google_db_advisor_recommended_indexes lista todos os novos índices recomendados para o banco de dados. Também inclui estimativas do armazenamento necessário para cada índice e o número de consultas que cada índice pode afetar.

  • google_db_advisor_workload_report lista cada consulta para a qual o consultor recomenda um ou mais índices novos. Cada linha resume as recomendações para a consulta relevante.

Por exemplo, para ver os resultados da análise mais recente da recomendação de índice, formatados como uma tabela, execute esta consulta:

SELECT * FROM google_db_advisor_recommended_indexes;

Se a análise mais recente do consultor de índice não encontrar recomendações, essa consulta retornará uma tabela sem linhas.

Como todos esses relatórios existem como visualizações de banco de dados comuns, é possível escrever consultas que filtram ou apresentam informações da maneira que você quiser. Por exemplo, para ver um relatório que combina índices recomendados com a consulta completa associada, mescle as visualizações google_db_advisor_workload_report e google_db_advisor_workload_statements nas respectivas colunas query_id:

SELECT DISTINCT recommended_indexes, query
FROM google_db_advisor_workload_report r, google_db_advisor_workload_statements s
WHERE r.query_id = s.query_id;

Solicitar manualmente uma análise de índice

Em vez de esperar pela próxima análise programada do consultor de índice, solicite que o AlloyDB execute uma análise imediatamente e exiba o relatório. Para fazer isso, execute esta função SQL:

SELECT * FROM google_db_advisor_recommend_indexes();

Após a conclusão da análise, o AlloyDB exibe um relatório em formato de tabela com a descrição e as necessidades estimadas de armazenamento de todos os índices recomendados. Se a análise não encontrar novos índices para recomendar, a visualização não conterá linhas.

Lembre-se que o papel do usuário do PostgreSQL que executa esse comando pode afetar as recomendações exibidas. Se essa consulta for executada por postgres ou outro usuário com o papel alloydbsuperuser, o AlloyDB vai exibir todas as recomendações atuais do consultor de índices. Caso contrário, o AlloyDB limita a exibição a recomendações de índice com base nas consultas emitidas pelo usuário atual do banco de dados.

Aplicar as recomendações do consultor de índice

No painel Query Insights no console do Google Cloud , clique em Criar índices para uma consulta, clique em Copiar todos os comandos de índice (ou Abrir comandos no Studio para abrir as instruções CREATE INDEX no AlloyDB Studio) e execute os comandos na instância principal. Para instruções detalhadas, consulte Criar índices recomendados no Query Insights.

Quando você consulta uma visualização de banco de dados diretamente, a coluna index da visualização google_db_advisor_recommended_indexes contém, em cada linha, uma instrução DDL CREATE INDEX completa do PostgreSQL para gerar o índice recomendado nessa linha.

Para aplicar a recomendação dessa linha, execute a instrução DDL exatamente como apresentada. Isso inclui copiar para a área de transferência e colá-lo em um comando psql.

Por exemplo, considere esta saída da execução manual de uma análise, usando a consulta descrita na seção anterior:

                    index                   | estimated_storage_size_in_mb
--------------------------------------------+------------------------------
 CREATE INDEX ON "School"."Students"("age") |                            3
(1 row)

Esse relatório contém uma única recomendação: adicionar um novo índice de coluna única na coluna age na tabela Students do esquema School. Para aplicar essa recomendação, insira uma consulta DDL exatamente como representado no relatório:

CREATE INDEX ON "School"."Students"("age");

Ver as consultas rastreadas do consultor de índice

A visualização google_db_advisor_workload_statements contém uma lista de todas as consultas que o consultor de índice rastreou, bem como metadados importantes para cada uma, como as seguintes métricas:

  • O número de vezes que a instância executou essa consulta
  • O tempo total que a instância gasta para processar essas consultas
  • O ID do usuário do banco de dados que executa essas consultas

Limpar as consultas rastreadas do consultor de índice

Para redefinir o comportamento do consultor de índice em uma instância, limpe as consultas rastreadas. Para fazer isso, execute esta função SQL:

SELECT google_db_advisor_reset();

O AlloyDB esvazia imediatamente a coleção de consultas rastreadas do consultor de índice.

Configurar o consultor de índice

O consultor de índice funciona na maioria dos casos de uso com as configurações padrão, mas é possível ajustar o comportamento dele definindo várias flags de banco de dados.

Por exemplo, é possível definir a flag google_db_advisor.enable_vector_index_advisor para permitir que o consultor de índice recomende índices para consultas vetoriais. Essa flag é ativada por padrão.

Para saber mais, consulte Flags do consultor de índice.

A seguir