Usar o consultor de índice

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

É possível consultar as recomendações como uma tabela ou solicitar uma análise e um relatório sob demanda a qualquer momento.

Ver as recomendações do consultor de índice

O AlloyDB executa automaticamente a análise do consultor de índice periodicamente. É possível ler os resultados em duas visualizações de tabela localizadas em cada um dos bancos de dados:

• google_db_advisor_recommended_indexes lista todos os índices novos 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 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 mostra 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.

A função 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 mostrar todas as recomendações atuais do index advisor. 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

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 representada 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 foi projetado para funcionar 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. Para saber mais, consulte a página de referência Flags do consultor de índice.