Usar o consultor de índice do Spanner

Esta página descreve o consultor de índice do Spanner e como é possível conferir e aplicar as recomendações de índice. O Index Advisor está disponível para bancos de dados com dialeto GoogleSQL e PostgreSQL.

O consultor de índice do Spanner analisa suas consultas para recomendar índices novos ou alterados que podem melhorar a performance da consulta. É possível conferir as recomendações do Index Advisor no console do Google Cloud usando uma das seguintes abordagens:

Para conferir as recomendações de CREATE INDEX e ALTER INDEX, use o console do Google Cloud.

Para mais informações sobre os índices do Spanner, consulte Índices secundários.

Limitações

O consultor de índice do Spanner tem as seguintes limitações:

  • Só oferece recomendações CREATE INDEX e ALTER INDEX. Não fornece recomendações de DROP INDEX para índices existentes.

  • Uma recomendação de índice só é mostrada se oferece um benefício de desempenho notório.

  • Se você for um usuário de controle de acesso detalhado ou não tiver acesso ao DDL, não será possível executar instruções DDL de recomendação de índice. Você pode copiar e salvar a recomendação.

Usar o plano de execução da consulta

Para conferir e aplicar as recomendações do consultor de índice do plano de execução de uma consulta, siga estas etapas.

Ver recomendações

Para conferir o plano de execução da consulta, execute uma consulta no console do Google Cloud:

  1. Acesse a página Instâncias do Spanner no console do Google Cloud.

    Acesse "Instâncias"

  2. Selecione a instância que contém o banco de dados que você quer consultar.

  3. Selecione o nome do banco de dados que você quer consultar.

  4. No menu de navegação, clique em Spanner Studio.

  5. Abra uma nova guia do editor SQL.

  6. No painel do editor, insira sua consulta SQL.

  7. Clique em Executar.

  8. Para conferir o plano de execução da consulta, clique na guia Explicação.

    O painel de informações mostra informações detalhadas sobre a consulta. Se o Spanner determinar que um índice novo ou alterado pode melhorar a performance da consulta, um card de recomendações de índice será exibido.

  9. Para conferir a instrução DDL de recomendação de índice, no card Recomendação de índice, clique em Ver detalhes.

Aplicar recomendações

A recomendação de índice do Spanner fornece instruções DDL CREATE INDEX e ALTER INDEX completas para índices recomendados.

Para aplicar a recomendação do consultor de índice, copie e execute a instrução DDL do consultor no editor do Spanner Studio exatamente como apresentado.

  1. No painel Index recommendation, marque a caixa de seleção ao lado das instruções DDL que você quer copiar.

  2. Clique em Copiar para uma nova guia.

  3. Na nova guia do editor do Spanner Studio, execute a instrução DDL copiada.

Usar o painel de insights de consulta

Para conferir e aplicar as recomendações do consultor de índice no painel de Query insights, siga estas etapas.

Ver recomendações

  1. Acesse a página Instâncias do Spanner no console do Google Cloud.

    Acesse "Instâncias"

  2. Selecione o nome da instância que contém o banco de dados que você quer consultar.

  3. Selecione o nome do banco de dados que você quer consultar.

  4. No menu de navegação, clique em Query Insights.

  5. Acesse a tabela Consultas e tags do TopN.

    A tabela mostra uma coluna Recomendação. Se o Spanner determinar que um índice novo ou alterado pode melhorar a performance da consulta, uma recomendação de índice será exibida. Para conferir como isso fica no console do Google Cloud, consulte Identificar uma tag de solicitação ou consulta potencialmente problemática.

  6. Para conferir a instrução DDL da recomendação de índice, clique em Recomendação de índice.

Aplicar recomendações

A recomendação de índice do Spanner fornece instruções DDL CREATE INDEX e ALTER INDEX completas para índices recomendados.

Para aplicar a recomendação do consultor de índice, copie e execute a instrução DDL do consultor no editor do Spanner Studio exatamente como apresentado.

  1. No painel Recomendação de índice, selecione as instruções DDL que você quer copiar.

    O Spanner gera recomendações para consultas TopN a cada 12 horas para as consultas TopN executadas nas 12 horas anteriores. O painel Recomendação de índice mostra um registro de quanto tempo atrás ele foi atualizado pela última vez.

    Visualização de uma recomendação de índice.

  2. Clique em Copiar para o Spanner Studio. O console do Google Cloud mostra o editor do Spanner Studio.

    Se você for um usuário de controle de acesso detalhado, o botão Copiar para o Spanner Studio não vai aparecer e você não vai conseguir executar a instrução DDL.

  3. No editor do Spanner Studio, execute a instrução DDL copiada.

A seguir