Use o consultor de índices do Spanner

Esta página descreve o consultor de índices do Spanner e como pode ver e aplicar as respetivas recomendações de índices. O consultor de índices está disponível para bases de dados com dialeto GoogleSQL e bases de dados com dialeto PostgreSQL.

O consultor de índices do Spanner analisa as suas consultas para recomendar índices novos ou alterados que podem melhorar o desempenho das consultas. Pode ver as recomendações do consultor de índices na Google Cloud consola através de qualquer uma das seguintes abordagens:

• Execute uma consulta e veja o respetivo plano de execução da consulta
• Use o painel de controlo de estatísticas de consultas do Spanner

Para ver as recomendações CREATE INDEX e ALTER INDEX, pode usar a consola. Google Cloud

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

Limitações

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

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

• Uma recomendação de índice só é apresentada se oferecer uma vantagem de desempenho notável.

• Se for um utilizador do controlo de acesso detalhado ou não tiver acesso à DDL, não pode executar declarações DDL de recomendações de índice. Pode copiar e guardar a recomendação.

Use o plano de execução de consultas

Para ver e aplicar as recomendações do consultor de índices a partir do plano de execução de uma consulta, siga estes passos.

Ver recomendações

Para ver o plano de execução da consulta, execute uma consulta na Google Cloud consola:

1. Aceda à página Instâncias do Spanner na Google Cloud consola.

   Aceda a Instâncias

2. Selecione a instância que contém a base de dados que quer consultar.

3. Selecione o nome da base de dados que quer consultar.

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

5. Abra um novo separador do editor de SQL.

6. No painel do editor, introduza a sua consulta SQL.

7. Clique em Executar.

8. Quando a consulta terminar, para ver o plano de execução da consulta, clique no separador 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 o desempenho das suas consultas, é apresentado um cartão de recomendações de índices.

9. Para ver a declaração DDL de recomendação de índice, no cartão Recomendação de índice, clique em Ver detalhes para ver o índice.

Aplique recomendações

A recomendação de índice do Spanner fornece instruções DDL CREATE INDEXcompletasALTER INDEX e CREATE INDEXpara os índices recomendados.

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

1. No painel Recomendação de índice, selecione a caixa de verificação junto às declarações DDL que quer copiar.

2. Clique em Copiar para novo separador.

3. No novo separador do editor do Spanner Studio, execute a declaração DDL copiada.

Use o painel de controlo Estatísticas de consultas

Para ver e aplicar as recomendações do consultor de índices no painel de controlo Estatísticas de consultas, siga estes passos.

Ver recomendações

1. Aceda à página Instâncias do Spanner na Google Cloud consola.

   Aceda a Instâncias

2. Selecione o nome da instância que contém a base de dados que quer consultar.

3. Selecione o nome da base de dados que quer consultar.

4. No menu de navegação, clique em Estatísticas de consultas.

5. Veja a tabela Principais consultas e etiquetas.

   A tabela mostra uma coluna Recomendação. Se o Spanner determinar que um índice novo ou alterado pode melhorar o desempenho das suas consultas, é apresentada uma recomendação de índice. Para ver o aspeto desta situação na Google Cloud consola, consulte Identifique uma consulta ou uma etiqueta de pedido potencialmente problemática.

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

Aplique recomendações

A recomendação de índice do Spanner fornece instruções DDL CREATE INDEXcompletasALTER INDEX e CREATE INDEXpara os índices recomendados.

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

1. No painel Recomendação de índice, selecione as declarações DDL que 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 apresenta um registo de há quanto tempo foi atualizado pela última vez.

   

2. Clique em Copiar para o Spanner Studio. Google Cloud A consola apresenta o editor do Spanner Studio.

   Se for um utilizador do controlo de acesso detalhado, não vê o botão Copiar para o Spanner Studio e não pode executar a declaração DDL.

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

O que se segue?

• Saiba mais acerca dos índices secundários do Spanner.

• Saiba mais sobre as práticas recomendadas de SQL.

• Saiba como resolver problemas de regressões de desempenho.