Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 consultor de índice no console Google Cloud usando uma das
seguintes abordagens:
Para conferir as recomendações de CREATE INDEX e ALTER INDEX, use
o console 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ó é exibida se oferece um benefício de performance
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 Google Cloud :
Acesse a página Instâncias do Spanner no
Google Cloud console.
Selecione a instância que contém o banco de dados que você quer consultar.
Selecione o nome do banco de dados que você quer consultar.
No menu de navegação, clique em Spanner Studio.
Abra uma nova guia do editor SQL.
No painel do editor, insira sua consulta SQL.
Clique em Executar.
Depois que a consulta terminar, clique na guia Explicação para conferir o plano de execução da consulta.
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.
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.
No painel Index recommendation, marque a caixa de seleção ao lado das instruções
DDL que você quer copiar.
Clique em Copiar para uma nova guia.
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
Acesse a página Instâncias do Spanner no
Google Cloud console.
Selecione o nome da instância que contém o banco de dados que você quer consultar.
Selecione o nome do banco de dados que você quer consultar.
No menu de navegação, clique em Query Insights.
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 o desempenho da consulta,
uma recomendação de índice será exibida. Para conferir como isso
aparece no console Google Cloud , consulte
Identificar uma tag de solicitação ou consulta potencialmente problemática.
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.
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.
Clique em Copiar para o Spanner Studio.
Google Cloud O console 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.
No editor do Spanner Studio, execute a instrução DDL copiada.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-05 UTC."],[],[],null,["# Use the Spanner index advisor\n\nThis page describes the Spanner index advisor and how you can view and\napply its index recommendations. The index advisor is available for\nGoogleSQL-dialect databases and PostgreSQL-dialect databases.\n\nThe Spanner index advisor analyzes your queries to recommend new\nor altered indexes that can improve your query performance. You can view the\nindex advisor's recommendations in the Google Cloud console using either of the\nfollowing approaches:\n\n- Run a query and view its [query execution plan](/spanner/docs/query-execution-plans)\n- Use the Spanner [Query insights dashboard](/spanner/docs/using-query-insights)\n\nTo view the `CREATE INDEX` and `ALTER INDEX` recommendations, you can\nuse the Google Cloud console.\n\nFor more information about Spanner indexes, see\n[Secondary indexes](/spanner/docs/secondary-indexes).\n\nLimitations\n-----------\n\nSpanner index advisor has the following limitations:\n\n- Only provides `CREATE INDEX` and `ALTER INDEX` recommendations. Doesn't\n provide `DROP INDEX` recommendations for existing indexes.\n\n- An index recommendation is only shown if it provides a noticeable performance\n benefit.\n\n- If you are a [fine-grained access control](/spanner/docs/fgac-about) user or if you don't\n have DDL access, you can't execute index recommendation DDL statements. You\n can copy and save the recommendation.\n\nUse the query execution plan\n----------------------------\n\nTo view and apply index advisor recommendations from a query's execution plan,\nfollow these steps.\n\n### View recommendations\n\nTo view the query execution plan, run a query in the Google Cloud console:\n\n1. Go to the Spanner **Instances** page in\n Google Cloud console.\n\n [Go to Instances](https://console.cloud.google.com/spanner/instances)\n2. Select the instance that contains the database that you want to query.\n\n3. Select the name of the database you want to query.\n\n4. In the navigation menu, click **Spanner Studio**.\n\n5. Open a new SQL editor tab.\n\n6. In the editor pane, enter your SQL query.\n\n7. Click **Run**.\n\n8. After the query has finished running, to see the query execution plan, click\n the **Explanation** tab.\n\n The information panel shows detailed information about the query. If\n Spanner determines that a new or altered index can improve\n your query performance, then an index recommendations card is displayed.\n9. To view the index recommendation DDL statement, in the **Index recommendation**\n card, click **View details** to view the index.\n\n### Apply recommendations\n\nThe Spanner index recommendation provides complete `CREATE INDEX`\nand `ALTER INDEX` DDL statements for recommended indexes.\n\nTo apply the index advisor's recommendation, copy and run the index advisor's\nDDL statement into the Spanner Studio editor exactly as presented.\n\n1. In the **Index recommendation** pane, select the checkbox next to the DDL\n statements that you want to copy.\n\n2. Click **Copy to new tab**.\n\n3. In the new Spanner Studio editor tab, run the copied DDL statement.\n\nUse the Query insights dashboard\n--------------------------------\n\nTo view and apply index advisor recommendations from the Query insights\ndashboard, follow these steps.\n\n### View recommendations\n\n1. Go to the Spanner **Instances** page in\n Google Cloud console.\n\n [Go to Instances](https://console.cloud.google.com/spanner/instances)\n2. Select the name of the instance containing the database you want to query.\n\n3. Select the name of the database you want to query.\n\n4. In the navigation menu, click **Query insights**.\n\n5. View the **TopN queries and tags** table.\n\n The table shows a **Recommendation** column. If Spanner\n determines that a new or altered index can improve your query performance,\n then an index recommendation is displayed. To view what this looks\n like in the Google Cloud console, see\n [Identify a potentially problematic query or request tag](/spanner/docs/using-query-insights#filter-db-load).\n6. To view the index recommendation DDL statement, click **Index recommendation**.\n\n### Apply recommendations\n\nThe Spanner index recommendation provides complete `CREATE INDEX`\nand `ALTER INDEX` DDL statements for recommended indexes.\n\nTo apply the index advisor's recommendation, copy and run the index advisor's\nDDL statement into the Spanner Studio editor exactly as presented.\n\n1. In the **Index recommendation** pane, select the DDL statements you want to\n copy.\n\n Spanner generates recommendations for TopN queries every 12\n hours for the TopN queries executed in the preceding 12 hours. The\n **Index recommendation** pane displays a record of how long ago it was last\n refreshed.\n\n2. Click **Copy to Spanner Studio** .\n Google Cloud console displays the **Spanner Studio** editor.\n\n If you are a fine-grained access control user, you don't see the **Copy to\n Spanner Studio** button, and you can't run the DDL statement.\n3. In the Spanner Studio editor, run the copied DDL statement.\n\nWhat's next\n-----------\n\n- Learn more about Spanner [secondary indexes](/spanner/docs/secondary-indexes).\n\n- Learn more [SQL best practices](/spanner/docs/sql-best-practices).\n\n- Learn how to [Troubleshoot performance regressions](/spanner/docs/troubleshooting-performance-regressions)."]]
