Usar o consultor de índice

Nesta página, descrevemos o consultor de índice do Cloud SQL para PostgreSQL e como é possível ver e aplicar as recomendações de índice.

O Cloud SQL 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 ver e consultar as recomendações do consultor de índice como uma tabela ou solicitar uma análise e relatório sob demanda a qualquer momento.

Ativar recomendações do consultor de índice

Para ativar as recomendações do consultor de índice, configure o Gemini em bancos de dados.

Desativar recomendações do consultor de índice

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

Ver as recomendações do consultor de índice

O Cloud SQL para PostgreSQL executa de maneira automática e periódica a análise do consultor de índice.

É possível ler os resultados nas visualizações em tabela a seguir, localizadas em cada um dos bancos de dados:

  • google_db_advisor_recommended_indexes: lista todos os índices novos recomendados para cada 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 essas informações. 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 Cloud SQL para PostgreSQL execute uma análise imediatamente e exiba o relatório. No Cloud SQL para PostgreSQL, é necessário aguardar pelo menos 15 minutos após a ativação do consultor de índice para executar uma análise manual. Para fazer isso, execute esta função SQL:

SELECT * FROM google_db_advisor_recommend_indexes();

Após a conclusão da análise, o Cloud SQL para PostgreSQL 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 a função do usuário que executa esse comando pode afetar as recomendações exibidas. O Cloud SQL para PostgreSQL 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 índice de coluna única na coluna age na tabela Students do esquema School. Para aplicar essa recomendação, insira uma consulta DDL conforme 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 cada 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 Cloud SQL para PostgreSQL esvazia imediatamente a coleção de consultas rastreadas do consultor de índice.