Neste documento, descrevemos como usar a assistência de IA no AlloyDB para PostgreSQL para resolver problemas de consultas lentas no AlloyDB. Você pode usar os recursos de assistência de IA do AlloyDB e do Gemini Cloud Assist para investigar, analisar, receber recomendações e, por fim, implementar essas recomendações para otimizar suas consultas no AlloyDB.
Antes de começar
Para resolver problemas de consultas lentas com a assistência da IA, faça o seguinte:
- Analise as limitações da solução de problemas assistida por IA.
- Ative a solução de problemas assistida por IA.
Papéis e permissões necessárias
Para saber os papéis e as permissões necessários para resolver problemas de consultas lentas com a assistência da IA, consulte Monitorar e resolver problemas com a IA.
Usar a assistência de IA
Para usar a assistência de IA e resolver problemas com consultas lentas, acesse o painel Query Insights da sua instância do AlloyDB no console do Google Cloud .
Tabela das principais consultas
Você pode começar a resolver problemas de consultas lentas com a assistência da IA na seção Tabela das principais consultas do painel Query Insights.
O AlloyDB pode ajudar você a identificar quais consultas estão sendo executadas mais lentamente do que a média durante um período de detecção específico. Depois que você seleciona um período no painel Insights de consultas, o AlloyDB verifica se alguma consulta está sendo executada mais lentamente do que a média usando um período de detecção de 24 horas antes do fim do período selecionado.
Quando você ajusta o filtro de período do gráfico Carga do banco de dados ou qualquer outro filtro, como banco de dados ou usuário, o AlloyDB atualiza a Tabela de consultas principais e executa novamente a detecção de anomalias com base na nova lista de consultas e em um período de detecção atualizado.
Quando o AlloyDB detecta uma anomalia, ele realiza uma análise de desempenho de referência para sua consulta depois que você clica em Analisar latência. O AlloyDB mapeia as métricas durante a anomalia para a consulta lenta e procura situações que podem ter causado o desempenho lento. Se o AlloyDB encontrar uma situação em potencial, você poderá conferir as evidências dela. Por fim, o AlloyDB oferece recomendações para corrigir e otimizar o desempenho das consultas.
Para resolver problemas de consultas lentas na tabela Principais consultas do painel Insights de consulta, faça o seguinte:
- No Google Cloud console, acesse a página Clusters. Acessar Clusters
- Na lista de clusters e instâncias, clique em uma instância.
- Clique em Query Insights.
- No gráfico Consultas executadas, use o filtro Intervalo de tempo para selecionar 1 hora, 6 horas, 1 dia, 7 dias, 30 dias ou um período personalizado.
- Na tabela Principais consultas, revise a lista de consultas do seu banco de dados.
- Se a opção Analisar latência aparecer ao lado do Tempo médio de execução de uma consulta, o AlloyDB terá detectado uma anomalia no desempenho da consulta. O AlloyDB verifica anomalias no período de 24 horas antes do fim do intervalo de tempo selecionado.
- Clique em Analisar latência para começar a resolver problemas com a assistência da IA. Isso gera a página Analisando a latência da consulta.
- Nenhuma das consultas listadas apresentou uma anomalia no período de detecção de 24 horas do intervalo de tempo selecionado.
- O Gemini Cloud Assist não está configurado.
Se nenhuma consulta mostrar Analisar latência ao lado de Tempo médio de execução, o motivo pode ser um dos seguintes:
Detalhes da consulta
Também é possível resolver problemas de uma consulta lenta com a assistência da IA na página Detalhes da consulta.
- No Google Cloud console, acesse a página Clusters. Acessar Clusters
- Na lista de clusters e instâncias, clique em uma instância.
- Clique em Insights de consulta para abrir o painel Insights de consulta.
- No painel Query insights, clique na consulta que você quer ver em Principais consultas. A página Detalhes da consulta é exibida.
- Opcional: use o filtro de período para selecionar 1 hora, 6 horas, 1 dia, 7 dias, 30 dias ou um período personalizado. Quando você ajusta o filtro de período da página Detalhes da consulta, o AlloyDB executa novamente a detecção de anomalias.
- Se o AlloyDB não detectar uma anomalia na consulta, você ainda poderá executar uma análise clicando em Analisar a performance da consulta. Isso gera a página Analisando a latência da consulta.
Analisar a latência da consulta
Com a ajuda da IA, é possível analisar e resolver problemas de latência da consulta.
Na página Analisando a latência da consulta, você pode conferir os seguintes detalhes sobre a consulta e o texto dela:
- Período da análise
- Período da anomalia detectada
- banco de dados
- Tempo médio de execução
- Hora da chamada
- Média de linhas retornadas
A página também oferece um gráfico de latência que mostra os valores de latência P50, P95 e P99 no período selecionado. O P50 mostra a latência mediana em que 50% dos usuários de consultas estão enfrentando alta latência e 50% estão enfrentando latência menor. Da mesma forma, as linhas P95 e P99 mostram que 95% e 99% dos usuários de consultas têm as latências de consulta indicadas. Para P95, 5% estão enfrentando uma latência maior, enquanto para P99, apenas 1% está enfrentando uma latência maior.
Você pode conferir o período específico em que ocorreu um aumento significativo na latência da consulta.
Período da análise
O período de análise consiste nas 24 horas que ocorrem antes do fim do intervalo de tempo selecionado no gráfico Carga do banco de dados do painel Insights de consulta ou na página Detalhes da consulta. O AlloyDB usa esse período para comparar as métricas de valor de referência com as métricas recuperadas durante o período da anomalia.
Na página Detalhes da consulta, se o AlloyDB tiver detectado uma anomalia na consulta, depois que você selecionar a consulta no painel Insights de consultas, o AlloyDB vai realizar uma análise de performance de linha de base para a consulta usando as últimas 24 horas a partir do final da anomalia. Se o AlloyDB não tiver detectado uma anomalia com a consulta e executar a detecção de anomalias novamente, o AlloyDB usará 48 horas antes do fim do período selecionado como o valor de referência de desempenho para o período de análise.
Período da anomalia detectada
O período da anomalia detectada representa um período em que o AlloyDB encontra uma mudança anômala no desempenho da consulta. O AlloyDB usa o desempenho de referência medido para a consulta durante o período de análise.
Se o AlloyDB detectar várias anomalias para uma consulta em um período selecionado, ele usará a última anomalia detectada.
Situação
Depois que você inicia a investigação, o AlloyDB analisa sua consulta e todos os dados históricos e tenta identificar uma situação subjacente que possa explicar a lentidão da consulta no período selecionado.
Por exemplo, uma situação em que sua consulta está lenta pode ser identificada como Mudança no volume de dados.
Ao identificar essa situação específica, o AlloyDB detectou um aumento anômalo no volume de dados para essa consulta. O AlloyDB também lista outras situações possíveis em que nenhuma anomalia é detectada, para que você possa eliminá-las como possíveis causas raiz.
Evidência
Para cada situação, o AlloyDB fornece uma lista de evidências para apoiar a descoberta. O AlloyDB baseia evidências em métricas coletadas da instância, do banco de dados e de execuções históricas da consulta.
As evidências apresentadas para cada situação refletem qualquer anomalia que o AlloyDB detecta para a consulta no período de detecção. O AlloyDB define uma anomalia quando uma métrica ultrapassa determinados limites ou atende a critérios específicos.
Neste exemplo, para apoiar a situação de uma mudança no volume de dados, você pode encontrar as seguintes evidências:
- Dados processados pela consulta: aumento de até 5989,97% na média de dados processados pela consulta.
- Tempo de execução da consulta: aumento de até 1.506,59% no tempo médio de execução.
- Hits de bloco compartilhado: a média de hits de bloco compartilhado aumentou 2.397,83%
Você também pode encontrar evidências que apoiam o desempenho típico ou não anômalo da consulta, como:
- Linhas retornadas: nenhuma mudança significativa foi detectada.
- Tempo de tratamento de dados: dados insuficientes para avaliar a mudança.
Evidências da execução de consultas padrão podem ajudar você a decidir qual recomendação é melhor para implementar.
Recomendações
Com base em todas as situações analisadas, o AlloyDB oferece uma ou mais recomendações práticas para ajudar a corrigir os problemas de desempenho lento das consultas. Nesse caso, o AlloyDB apresenta as recomendações com uma análise de custo-benefício para que você possa tomar uma decisão informada sobre a implementação.
Por exemplo, você pode receber as seguintes recomendações:
- Criar índices recomendados: crie um índice em
country
para melhorar o desempenho desta consulta.
Para implementar essa recomendação, faça o seguinte:
- Na tabela Recomendações, clique em Ver detalhes ao lado da recomendação que você quer implementar. A janela Insight e recomendação vai aparecer.
- Na janela Insight e recomendação, analise a Ação recomendada e as Tabelas afetadas.
- Opcional: se quiser saber mais sobre as recomendações de índice, clique em Como isso ajuda para abrir o Gemini Cloud Assist.
- Clique em Copiar todos os comandos de índice.
- Autentique-se no AlloyDB Studio.
- Cole o comando
CREATE INDEX
no AlloyDB Studio para criar o índice. Para mais informações sobre como executar comandos SQL no AlloyDB Studio, consulte Gerenciar dados com o AlloyDB Studio.

Se quiser continuar solucionando problemas ou receber mais ajuda com a performance das consultas, abra o Gemini Cloud Assist. Para mais informações, consulte Observar e resolver problemas com a assistência de IA.