Utiliser le conseiller d'index AlloyDB pour PostgreSQL avec les insights sur les requêtes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment utiliser le conseiller d'index AlloyDB pour PostgreSQL avec Query Insights.
Vous pouvez utiliser le conseiller d'index avec Insights sur les requêtes pour afficher ses recommandations et créer des index recommandés afin d'améliorer les performances des requêtes.
Pour en savoir plus sur le conseiller d'index, consultez la présentation du conseiller d'index.
Pour savoir comment utiliser le conseiller d'index pour afficher et interroger des recommandations sous forme de tableau, ou pour demander une analyse et un rapport à la demande, consultez Utiliser le conseiller d'index.
Pour utiliser le conseiller d'index AlloyDB, vous devez disposer des autorisations suivantes :
Pour accéder aux recommandations d'index, vous devez disposer des autorisations nécessaires pour accéder au tableau de bord "Insights sur les requêtes AlloyDB".
Pour modifier les paramètres du conseiller d'index, vous devez disposer des autorisations nécessaires pour mettre à jour les instances AlloyDB.
Pour obtenir ces autorisations, demandez à votre administrateur de vous attribuer l'un des rôles suivants :
Dans la liste des clusters et des instances, cliquez sur une instance.
Cliquez sur Insights sur les requêtes.
Cliquez sur Modifier les paramètres.
Désactivez les recommandations du conseiller d'index en décochant l'option Activer les recommandations. Les recommandations du conseiller d'index sont activées par défaut.
Modifier la fréquence d'actualisation des recommandations du conseiller d'index
Pour modifier la fréquence d'actualisation, procédez comme suit :
Dans la console Google Cloud , accédez à la page Clusters.
Dans la liste des clusters et des instances, cliquez sur une instance.
Cliquez sur Insights sur les requêtes.
Cliquez sur Modifier les paramètres.
Augmentez ou diminuez la fréquence d'actualisation des recommandations de l'outil de conseil sur les index. La fréquence d'actualisation par défaut est de 24 heures.
Afficher et filtrer les recommandations du conseiller d'index
Dans la console Google Cloud , accédez à la page Clusters.
Dans la liste des clusters et des instances, cliquez sur une instance.
Cliquez sur Insights sur les requêtes. Les recommandations du conseiller d'index sont affichées dans la colonne Recommandations du tableau Dimensions principales par charge de la base de données.
(Facultatif) Pour n'afficher que les requêtes avec des recommandations CREATE INDEX, ajoutez un filtre pour le champ Recommandation: Créer des index.
Afficher les recommandations pour une requête
Pour afficher les détails des recommandations d'index pour une requête spécifique, procédez comme suit:
Dans la console Google Cloud , accédez à la page Clusters.
Dans la liste des clusters et des instances, cliquez sur une instance.
Cliquez sur Insights sur les requêtes.
Dans le tableau Dimensions principales par charge de la base de données, cliquez sur Requêtes.
Pour obtenir les détails d'une recommandation sur une requête, effectuez l'une des opérations suivantes :
Cliquez sur une requête pour en savoir plus sur les recommandations de la requête sélectionnée, y compris les informations suivantes:
Impact sur les performances (élevé, moyen et faible): estimation de la vitesse de requête après la création de tous les index recommandés.
Recommandations: permet de créer des recommandations d'index.
Tables concernées : nombre de tables qui seront concernées lorsque des index seront créés.
Espace de stockage supplémentaire estimé nécessaire: taille d'espace de stockage estimée nécessaire pour créer tous les index recommandés.
Nombre de requêtes concernées : nombre total de requêtes de la charge de travail concernées par les recommandations d'index. Un indice peut bénéficier de plusieurs requêtes.
Cliquez sur Créer des index pour une requête spécifique afin d'obtenir des recommandations détaillées sur la création d'index afin d'améliorer les performances des requêtes.
Afficher les requêtes concernées
Dans la console Google Cloud , accédez à la page Clusters.
Découvrez comment utiliser le conseiller d'index pour afficher et interroger des recommandations sous forme de tableau, ou pour demander une analyse et un rapport à la demande.
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/04 (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/04 (UTC)."],[[["\u003cp\u003eThis page outlines how to use the AlloyDB for PostgreSQL index advisor in conjunction with query insights to optimize query performance by viewing and implementing index recommendations.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage index advisor recommendations by enabling or disabling them and adjusting the refresh frequency within the Query Insights settings of your AlloyDB cluster.\u003c/p\u003e\n"],["\u003cp\u003eThe index advisor provides insights such as performance impact, tables impacted, estimated storage needed, and number of impacted queries for each recommendation, which are all located in the \u003cstrong\u003eQueries\u003c/strong\u003e section of the \u003cstrong\u003eTop dimensions by database load\u003c/strong\u003e table.\u003c/p\u003e\n"],["\u003cp\u003eYou can directly copy and execute the \u003ccode\u003eCREATE INDEX\u003c/code\u003e commands generated by the index advisor to create the recommended indexes, which will be found after clicking \u003cstrong\u003eCreate Indexes\u003c/strong\u003e for a given query.\u003c/p\u003e\n"],["\u003cp\u003eAccessing the index advisor recommendations and editing its settings requires specific permissions, such as the Basic viewer or Database Insights viewer roles, that can be granted by an administrator.\u003c/p\u003e\n"]]],[],null,["# Use the AlloyDB for PostgreSQL index advisor with query insights\n\nThis page describes how you can use the AlloyDB for PostgreSQL index advisor with\nquery insights.\n\nYou can use the index advisor with query insights to view index advisor\nrecommendations and create recommended indexes to improve query performance.\nTo learn more about the index advisor, see\n[Index advisor overview](/alloydb/docs/index-advisor-overview).\n\nYou can use Gemini Cloud Assist to help you monitor and troubleshoot\nyour AlloyDB resources. For more information, see\n[Monitor and troubleshoot with Gemini assistance](/alloydb/docs/monitor-troubleshoot-with-gemini).\n\nTo learn how to use the index advisor to view and query recommendations\nas a table, or to request an on-demand analysis and report, see\n[Use the index advisor](/alloydb/docs/use-index-advisor).\n\nBefore you begin\n----------------\n\nTo access the query insights dashboard,\n[enable access to AlloyDB in your\nGoogle Cloud project](/alloydb/docs/project-enable-access).\n\n### Required roles\n\nTo use the AlloyDB index advisor, you need permissions to do the\nfollowing:\n\n- To access index recommendations, you need permissions to access the AlloyDB query insights dashboard.\n- To edit the index advisor settings, you need permissions to update AlloyDB instances.\n\nTo get these permissions, ask your administrator to grant you one of the\nfollowing roles:\n\n- Basic viewer (`roles/viewer`)\n- Database Insights viewer (`roles/databaseinsights.viewer`)\n\nFor more information about granting roles, see\n[Manage access](/iam/docs/granting-changing-revoking-access).\n\nDisable index advisor recommendations\n-------------------------------------\n\nTo disable index advisor recommendations, follow these steps:\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the list of clusters and instances, click an instance.\n\n3. Click **Query Insights**.\n\n4. Click **Edit settings**.\n\n5. Disable the index advisor recommendations by deselecting **Enable\n recommendations**. Index advisor recommendations are enabled by default.\n\nChange the refresh frequency for index advisor recommendations\n--------------------------------------------------------------\n\nTo change the refresh frequency, follow these steps:\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the list of clusters and instances, click an instance.\n\n3. Click **Query insights**.\n\n4. Click **Edit settings**.\n\n5. Increase or decrease the refresh frequency for index advisor\n recommendations. The default refresh frequency is every 24 hours.\n\nView and filter the index advisor recommendations\n-------------------------------------------------\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the list of clusters and instances, click an instance.\n\n3. Click **Query insights** . The index advisor recommendations are displayed in\n the **Recommendations** column of the **Top dimensions by database load**\n table.\n\n4. (Optional) To view only queries with CREATE INDEX recommendations, add a\n filter for **Recommendation: Create Indexes**.\n\nView recommendations for a query\n--------------------------------\n\nTo view details of index recommendations for a specific query, follow these\nsteps:\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the list of clusters and instances, click an instance.\n\n3. Click **Query insights**.\n\n4. In the **Top dimensions by database load** table, click **Queries**.\n\n5. To learn recommendation details about a query, do one of the following:\n\n - Click a query to learn more about recommendations for the selected query, including the following information:\n - **Performance impact** (high, medium, and low): The estimated query speed after all recommended indexes are created.\n - **Recommendations**: Create index recommendations.\n - **Tables impacted**: The number of tables that will be impacted when indexes are created.\n - **Additional estimated storage needed**: The estimated storage size needed to create all the recommended indexes.\n - **Number of impacted queries**: The total number of queries in the workload impacted by the index recommendations. An index may benefit multiple queries.\n - Click **Create Indexes** for a specific query to learn detailed recommendations about creating indexes to improve query performance.\n\nView impacted queries\n---------------------\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the list of clusters and instances, click an instance.\n\n3. Click **Query insights**.\n\n4. In the **Top dimensions by database load** table, click **Queries**.\n\n5. Click **Create indexes** for a specific query.\n\n6. Click **Show impacted queries**.\n\n7. Click a query to learn details about the impacted query.\n\nCreate recommended indexes\n--------------------------\n\n1. In the Google Cloud console, go to the **Clusters** page.\n\n [Go to Clusters](https://console.cloud.google.com/alloydb/clusters)\n2. From the list of clusters and instances, click an instance.\n\n3. Click **Query insights**.\n\n4. In the **Top dimensions by database load** table, click **Queries**.\n\n5. Click **Create Indexes** for a specific query.\n\n6. Click **Copy all index commands**. The CREATE INDEX commands are copied\n to your clipboard.\n\n7. Connect to the primary instance on the command line.\n\n8. To create the recommended indexes, run the commands that were copied to\n your clipboard, for example:\n\n ```sql\n CREATE INDEX ON \"public\".\"demo_order\" (\"customer_id\");\n ```\n\nWhat's next\n-----------\n\n- Learn how to [use the index advisor](/alloydb/docs/use-index-advisor) to view and query recommendations as a table, or to request an on-demand analysis and report.\n- Learn how [AlloyDB helps make smart indexes](https://cloud.google.com/blog/products/databases/how-the-alloydb-index-advisor-helps-make-smart-indexes)."]]
