Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page décrit le conseiller d'index Spanner et explique comment afficher et appliquer ses recommandations d'index. Le conseiller d'index est disponible pour les bases de données en dialecte Google SQL et en dialecte PostgreSQL.
Le conseiller d'index Spanner analyse vos requêtes pour vous recommander de nouveaux index ou des index modifiés qui peuvent améliorer les performances de vos requêtes. Vous pouvez afficher les recommandations du conseiller d'index dans la console Google Cloud en utilisant l'une des approches suivantes:
Pour afficher les recommandations CREATE INDEX et ALTER INDEX, vous pouvez utiliser la console Google Cloud .
Pour en savoir plus sur les index Spanner, consultez la section Index secondaires.
Limites
Le conseiller d'index Spanner présente les limites suivantes:
ne fournit que des recommandations CREATE INDEX et ALTER INDEX. Ne fournit pas de recommandations DROP INDEX pour les index existants.
Une recommandation d'index n'est affichée que si elle offre un avantage de performances notable.
Si vous utilisez le contrôle des accès ultraprécis ou si vous n'avez pas accès à DDL, vous ne pouvez pas exécuter d'instructions DDL de recommandation d'index. Vous pouvez copier et enregistrer la recommandation.
Utiliser le plan d'exécution de la requête
Pour afficher et appliquer les recommandations du conseiller d'index à partir du plan d'exécution d'une requête, procédez comme suit.
Afficher les recommandations
Pour afficher le plan d'exécution de la requête, exécutez une requête dans la console Google Cloud :
Accédez à la page Instances de Spanner dans la consoleGoogle Cloud .
Sélectionnez l'instance contenant la base de données que vous souhaitez interroger.
Sélectionnez le nom de la base de données que vous souhaitez interroger.
Dans le menu de navigation, cliquez sur Spanner Studio.
Ouvrez un nouvel onglet de l'éditeur SQL.
Dans le volet de l'éditeur, saisissez votre requête SQL.
Cliquez sur Exécuter.
Une fois l'exécution de la requête terminée, cliquez sur l'onglet Explanation (Explication) pour afficher le plan d'exécution de la requête.
Le panneau d'informations affiche des informations détaillées sur la requête. Si Spanner détermine qu'un nouvel index ou un index modifié peut améliorer les performances de vos requêtes, une fiche de recommandations d'index s'affiche.
Pour afficher l'instruction DDL de recommandation d'index, dans la fiche Recommandation d'index, cliquez sur Afficher les détails pour afficher l'index.
Appliquer les recommandations
La recommandation d'index Spanner fournit des instructions DDL CREATE INDEX et ALTER INDEX complètes pour les index recommandés.
Pour appliquer la recommandation du conseiller d'index, copiez et exécutez l'instruction DDL du conseiller d'index dans l'éditeur Spanner Studio exactement comme présenté.
Dans le volet Recommandation d'index, cochez la case à côté des instructions LDD que vous souhaitez copier.
Cliquez sur Copier dans un nouvel onglet.
Dans le nouvel onglet de l'éditeur Spanner Studio, exécutez l'instruction DDL copiée.
Utiliser le tableau de bord d'Insights sur les requêtes
Pour afficher et appliquer les recommandations du conseiller d'index à partir du tableau de bord "Insights sur les requêtes", procédez comme suit :
Afficher les recommandations
Accédez à la page Instances de Spanner dans la consoleGoogle Cloud .
Sélectionnez le nom de l'instance contenant la base de données que vous souhaitez interroger.
Sélectionnez le nom de la base de données que vous souhaitez interroger.
Dans le menu de navigation, cliquez sur Insights sur les requêtes.
Affichez le tableau Requêtes et tags TopN.
Le tableau comporte une colonne Recommandation. Si Spanner détermine qu'un nouvel index ou un index modifié peut améliorer les performances de vos requêtes, une recommandation d'index s'affiche. Pour voir à quoi cela ressemble dans la console Google Cloud , consultez Identifier une requête ou un tag de requête potentiellement problématique.
Pour afficher l'instruction LDD de recommandation d'index, cliquez sur Recommandation d'index.
Appliquer les recommandations
La recommandation d'index Spanner fournit des instructions DDL CREATE INDEX et ALTER INDEX complètes pour les index recommandés.
Pour appliquer la recommandation du conseiller d'index, copiez et exécutez l'instruction DDL du conseiller d'index dans l'éditeur Spanner Studio exactement comme présenté.
Dans le volet Recommandation d'index, sélectionnez les instructions DDL que vous souhaitez copier.
Spanner génère des recommandations pour les requêtes TopN toutes les 12 heures pour les requêtes TopN exécutées au cours des 12 heures précédentes. Le volet Recommandation d'index indique la date et l'heure de la dernière actualisation.
Cliquez sur Copier dans Spanner Studio. La consoleGoogle Cloud affiche l'éditeur Spanner Studio.
Si vous utilisez le contrôle des accès ultraprécis, le bouton Copier dans Spanner Studio ne s'affiche pas et vous ne pouvez pas exécuter l'instruction DDL.
Dans l'éditeur Spanner Studio, exécutez l'instruction DDL copiée.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/05 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
