Utilizzare il suggerimento sull'indicizzazione di Spanner
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive Index Advisor di Spanner e come visualizzare e
applicare i relativi consigli per gli indici. L'Advisor per gli indici è disponibile per i database in dialetto Google SQL e PostgreSQL.
Il consulente per l'indicizzazione di Spanner analizza le query per consigliare nuovi o modificati indici che possono migliorare le prestazioni delle query. Puoi visualizzare i consigli dell'advisor per gli indici nella Google Cloud console utilizzando uno dei seguenti approcci:
Per visualizzare i consigli CREATE INDEX e ALTER INDEX, puoi utilizzare la console Google Cloud .
Per saperne di più sugli indici Spanner, consulta
Indici secondari.
Limitazioni
Il consulente per gli indici Spanner presenta le seguenti limitazioni:
Fornisce solo consigli per CREATE INDEX e ALTER INDEX. Non fornisce consigli DROP INDEX per gli indici esistenti.
Un suggerimento sull'indice viene mostrato solo se offre un vantaggio significativo per il rendimento.
Se sei un utente con controllo dell'accesso granulare o se non hai accesso DDL, non puoi eseguire istruzioni DDL per i consigli sugli indici. Puoi copiare e salvare il consiglio.
Utilizzare il piano di esecuzione delle query
Per visualizzare e applicare i consigli di Index Advisor dal piano di esecuzione di una query, segui questi passaggi.
Visualizza i suggerimenti
Per visualizzare il piano di esecuzione della query, esegui una query nella Google Cloud console:
Vai alla pagina Istanze di Spanner nella consoleGoogle Cloud .
Seleziona l'istanza contenente il database su cui vuoi eseguire una query.
Seleziona il nome del database su cui vuoi eseguire una query.
Nel menu di navigazione, fai clic su Spanner Studio.
Apri una nuova scheda dell'editor SQL.
Nel riquadro dell'editor, inserisci la query SQL.
Fai clic su Esegui.
Al termine dell'esecuzione della query, per visualizzare il piano di esecuzione della query, fai clic sulla scheda Spiegazione.
Il riquadro delle informazioni mostra informazioni dettagliate sulla query. Se Spanner determina che un indice nuovo o modificato può migliorare le prestazioni delle query, viene visualizzata una scheda di suggerimenti per gli indici.
Per visualizzare l'istruzione DDL del consiglio per l'indice, nella scheda Consiglio per l'indice, fai clic su Visualizza dettagli per visualizzare l'indice.
Applicare i consigli
Il suggerimento di indicizzazione di Spanner fornisce istruzioni DDL complete per gli indici consigliati.CREATE INDEXALTER INDEX
Per applicare il consiglio dell'Advisor per gli indici, copia e esegui l'istruzione DDL dell'Advisor per gli indici nell'editor di Spanner Studio esattamente come mostrato.
Nel riquadro Consiglio per l'indice, seleziona la casella di controllo accanto alle istruzioni DDL da copiare.
Fai clic su Copia in una nuova scheda.
Nella nuova scheda dell'editor di Spanner Studio, esegui l'istruzione DDL copiata.
Utilizzare la dashboard Query Insights
Per visualizzare e applicare i consigli di Index Advisor dalla dashboard Approfondimenti sulle query:
Visualizza i suggerimenti
Vai alla pagina Istanze di Spanner nella consoleGoogle Cloud .
Seleziona il nome dell'istanza contenente il database su cui vuoi eseguire una query.
Seleziona il nome del database su cui vuoi eseguire una query.
Nel menu di navigazione, fai clic su Approfondimenti sulle query.
Visualizza la tabella Query e tag TopN.
La tabella mostra una colonna Consiglio. Se Spanner
determina che un indice nuovo o modificato può migliorare le prestazioni delle query,
viene visualizzato un suggerimento sull'indice. Per visualizzare come appare nella Google Cloud console, consulta
Identificare una query o un tag richiesta potenzialmente problematici.
Per visualizzare l'istruzione DDL del consiglio sull'indice, fai clic su Suggerimento sull'indicizzazione.
Applicare i consigli
Il suggerimento di indicizzazione di Spanner fornisce istruzioni DDL complete per gli indici consigliati.CREATE INDEXALTER INDEX
Per applicare il consiglio dell'Advisor per gli indici, copia e esegui l'istruzione DDL dell'Advisor per gli indici nell'editor di Spanner Studio esattamente come mostrato.
Nel riquadro Consiglio per l'indice, seleziona le istruzioni DDL da copiare.
Spanner genera consigli per le query TopN ogni 12 ore per le query TopN eseguite nelle 12 ore precedenti. Il riquadro Consiglio per l'indice mostra un record del tempo trascorso dall'ultimo aggiornamento.
Fai clic su Copia in Spanner Studio.
Google Cloud console mostra l'editor di Spanner Studio.
Se sei un utente con controllo dell'accesso granulare, non vedi il pulsante Copia in
Spanner Studio e non puoi eseguire l'istruzione DDL.
Nell'editor di Spanner Studio, esegui l'istruzione DDL copiata.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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)."]]
