Usar o consultor de índice do Spanner

Nesta página, descrevemos o consultor de índice do Spanner e como é possível ver e aplicar as recomendações de índice. O consultor de índice 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 o desempenho da consulta. É possível conferir as recomendações do consultor de índice no console do Google Cloud usando uma das seguintes abordagens:

Para ver 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 índices do Spanner tem as seguintes limitações:

  • Fornece apenas recomendações de CREATE INDEX e ALTER INDEX. Não fornece recomendações de DROP INDEX para índices atuais.

  • Uma recomendação de índice só será mostrada se oferecer um benefício de desempenho perceptível.

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

Usar o plano de execução de consulta

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

Ver recomendações

Para ver 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 Google Cloud console.

    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 de SQL.

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

  7. Clique em Executar.

  8. Depois que a consulta terminar, clique na guia Explicação para ver o plano de execução da consulta.

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

  9. Para ver a instrução DDL da 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 os índices recomendados.

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

  1. No painel Recomendação de índice, 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 do Query Insights

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

Ver recomendações

  1. Acesse a página Instâncias do Spanner no console doGoogle 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. Confira 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 o desempenho da consulta, uma recomendação de índice será exibida. Para ver como isso aparece no console do Google Cloud , consulte Identificar uma consulta ou tag de solicitação potencialmente problemática.

  6. Para ver a instrução DDL de 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 os índices recomendados.

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

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

    O Spanner gera recomendações para as 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 doGoogle Cloud mostra o editor do Spanner Studio.

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

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

A seguir