Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Auf dieser Seite wird der Spanner-Indexberater beschrieben und wie Sie seine Indexempfehlungen aufrufen und anwenden können. Der Indexberater ist für Datenbanken mit Google SQL- und PostgreSQL-Dialekt verfügbar.
Der Spanner-Indexberater analysiert Ihre Abfragen, um neue oder geänderte Indexe zu empfehlen, mit denen sich die Abfrageleistung verbessern lässt. Sie können sich die Empfehlungen des Indexberaters in der Google Cloud Console auf folgende Arten ansehen:
Sie können sich die CREATE INDEX- und ALTER INDEX-Empfehlungen in der Google Cloud -Konsole ansehen.
Weitere Informationen zu Spanner-Indexen finden Sie unter Sekundäre Indexe.
Beschränkungen
Für den Spanner-Indexberater gelten die folgenden Einschränkungen:
Es werden nur Empfehlungen für CREATE INDEX und ALTER INDEX angezeigt. Es werden keine DROP INDEX-Empfehlungen für vorhandene Indexe bereitgestellt.
Eine Indexempfehlung wird nur angezeigt, wenn dadurch ein deutlicher Leistungsvorteil erzielt wird.
Wenn Sie die detaillierte Zugriffssteuerung verwenden oder keinen DDL-Zugriff haben, können Sie keine DDL-Anweisungen für Indexempfehlungen ausführen. Sie können die Empfehlung kopieren und speichern.
Abfrageausführungsplan verwenden
So rufen Sie Empfehlungen von Index Advisor aus dem Ausführungsplan einer Abfrage auf und wenden sie an:
Empfehlungen abrufen
Führen Sie eine Abfrage in der Google Cloud Console aus, um den Abfrageausführungsplan aufzurufen:
Rufen Sie in derGoogle Cloud Console die Seite Spanner-Instanzen auf.
Wählen Sie die Instanz aus, die die Datenbank enthält, die Sie abfragen möchten.
Wählen Sie den Namen der Datenbank aus, die Sie abfragen möchten.
Klicken Sie im Navigationsmenü auf Spanner Studio.
Öffnen Sie einen neuen Tab im SQL-Editor.
Geben Sie im Editorbereich Ihre SQL-Abfrage ein.
Klicken Sie auf Ausführen.
Klicken Sie nach Abschluss der Abfrage auf den Tab Erläuterung, um den Abfrageausführungsplan aufzurufen.
Im Infofeld werden detaillierte Informationen zur Abfrage angezeigt. Wenn Spanner feststellt, dass ein neuer oder geänderter Index die Abfrageleistung verbessern kann, wird eine Karte mit Indexempfehlungen angezeigt.
Wenn Sie die DDL-Anweisung für die Indexempfehlung aufrufen möchten, klicken Sie auf der Karte Indexempfehlung auf Details ansehen.
Empfehlungen übernehmen
Die Spanner-Indexempfehlung enthält vollständige DDL-Anweisungen CREATE INDEX und ALTER INDEX für empfohlene Indexe.
Wenn Sie die Empfehlung des Indexberaters anwenden möchten, kopieren Sie die DDL-Anweisung des Indexberaters und führen Sie sie genau wie dargestellt im Spanner Studio-Editor aus.
Aktivieren Sie im Bereich Indexempfehlung die Kästchen neben den DDL-Anweisungen, die Sie kopieren möchten.
Klicken Sie auf In neuen Tab kopieren.
Führen Sie die kopierte DDL-Anweisung auf dem neuen Spanner Studio-Editortab aus.
Query Insights-Dashboard verwenden
So rufen Sie Empfehlungen von Index Advisor im Query Insights-Dashboard auf und wenden sie an:
Empfehlungen abrufen
Rufen Sie in derGoogle Cloud Console die Seite Spanner-Instanzen auf.
Klicken Sie auf Indexempfehlung, um die DDL-Anweisung für die Indexempfehlung aufzurufen.
Empfehlungen übernehmen
Die Spanner-Indexempfehlung enthält vollständige DDL-Anweisungen CREATE INDEX und ALTER INDEX für empfohlene Indexe.
Wenn Sie die Empfehlung des Indexberaters anwenden möchten, kopieren Sie die DDL-Anweisung des Indexberaters und führen Sie sie genau wie dargestellt im Spanner Studio-Editor aus.
Wählen Sie im Bereich Indexempfehlung die DDL-Anweisungen aus, die Sie kopieren möchten.
Spanner generiert alle 12 Stunden Empfehlungen für TopN-Abfragen für die TopN-Abfragen, die in den letzten 12 Stunden ausgeführt wurden. Im Bereich Indexempfehlung wird angezeigt, wie lange es her ist, dass der Index zuletzt aktualisiert wurde.
Klicken Sie auf In Spanner Studio kopieren. Im Spanner Studio-Editor wird dieGoogle Cloud Konsole angezeigt.
Wenn Sie ein Nutzer mit detaillierter Zugriffssteuerung sind, wird die Schaltfläche In Spanner Studio kopieren nicht angezeigt und Sie können die DDL-Anweisung nicht ausführen.
Führen Sie die kopierte DDL-Anweisung im Spanner Studio-Editor aus.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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)."]]
