Gérer les tables ouvertes et les définitions de tables ouvertes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
MySQL | PostgreSQL | SQL Server
Cette page explique comment gérer les instances avec un nombre élevé de tables ouvertes et de définitions de tables ouvertes. Cet outil de recommandation est appelé Gérer les tables ouvertes.
Chaque jour, cet outil de recommandation analyse les métriques pour les éléments suivants:
Le nombre de tables ouvertes ou de définitions de tables ouvertes pour une instance comme suit:
Si le nombre de tables ouvertes ou de définitions de tables ouvertes augmente d'une table toutes les deux secondes, ou plus rapidement, au cours des dernières 24 heures.
Si le nombre de tables ouvertes ou de définitions de tables ouvertes est supérieur ou égal à la valeur de table_open_cache et table_definition_cache, respectivement.
Si l'une de ces conditions est remplie, l'outil de recommandation vous conseille d'augmenter la valeur de table_open_cache ou table_definition_cache.
Pour savoir comment augmenter la valeur de table_open_cache et de table_definition_cache, consultez la section Limite de tables.
Pour obtenir les autorisations permettant d'afficher et d'utiliser les insights et les recommandations, assurez-vous de disposer des rôles IAM (Identity and Access Management) requis.
Dans la bannière Améliorez l'état de l'instance en analysant les problèmes et en agissant sur la base des recommandations, cliquez sur Développer les détails.
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations
Remplacez les éléments suivants :
PROJECT_ID : ID de votre projet.
LOCATION : région où se trouvent vos instances, par exemple us-central1.
Afficher les insights et les recommandations détaillées
Pour afficher les insights et les recommandations détaillées, procédez comme suit :
Console
Effectuez l'une des opérations suivantes :
Sur la page Recommandations de performances, cliquez sur la fiche Recommandations de performances, puis sur Gérer les tables ouvertes. Le panneau de recommandations s'affiche. Il contient des insights et des recommandations détaillées pour l'instance.
Sur la page Instances, cliquez sur Gérer les tables ouvertes.
La liste des instances n'affiche que les instances pour lesquelles la recommandation s'applique.
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.cloudsql.instance.PerformanceInsight/insights
Remplacez les éléments suivants :
PROJECT_ID : ID de votre projet.
LOCATION : région où se trouvent vos instances, par exemple us-central1.
Appliquer la recommandation
Pour mettre en œuvre cette recommandation, effectuez l'une des opérations suivantes:
Pour un grand nombre de tables ouvertes, augmentez la valeur de table_open_cache de 500 jusqu'à ce que la recommandation disparaisse.
Pour un grand nombre de définitions de tables ouvertes, augmentez la valeur table_definition_cache de 500 jusqu'à ce que la recommandation disparaisse.
Cette recommandation est mise à jour quotidiennement. Par conséquent, après avoir augmenté la valeur de table_open_cache ou table_definition_cache, attendez 24 heures avant de vérifier à nouveau la recommandation. Pour savoir comment augmenter la valeur de table_open_cache et de table_definition_cache, consultez la section Limite de tables.
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)."],[],[],null,["# Manage open tables and open table definitions\n\n\u003cbr /\u003e\n\nMySQL \\| PostgreSQL \\| SQL Server\n\n\u003cbr /\u003e\n\n|\n| **Preview\n| --- [Gemini in Databases](/gemini/docs/overview)**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| You can process personal data for this feature as outlined in the\n| [Cloud Data Processing\n| Addendum](/terms/data-processing-addendum), subject to the obligations and restrictions described in the agreement under\n| which you access Google Cloud.\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nThis page describes how to manage instances with a high number of open tables\nand a high number of open table definitions. This [recommender](/recommender/docs/recommenders) is called **Manage open tables**.\n\nEvery day, this recommender analyzes metrics for the following:\n\n- The number of open tables or open table definitions for an instance as follows:\n - If the number of open tables or open table definitions increases by 1 table every 2 seconds, or faster, during the previous 24 hours.\n - If the number of open tables or open table definitions is equal to or more than the value of `table_open_cache` and `table_definition_cache`, respectively. If either of these are true, then the recommender advises you to increase the value of `table_open_cache` or `table_definition_cache`.\n\nFor more information on increasing the value of `table_open_cache` and\n`table_definition_cache`, see [Table limit](/sql/docs/quotas#table_limit).\n\nPricing\n-------\n\nThe **Manage open tables** recommender is in the *Standard*\n[Recommender pricing tier](/recommender/pricing).\n\nBefore you begin\n----------------\n\n[Enable the Recommender API](/recommender/docs/enabling).\n\n### Required roles and permissions\n\nTo get the permissions to view and work with insights and recommendations,\nensure that you have the required [Identity and Access Management (IAM) roles](/sql/docs/mysql/project-access-control#roles).\n\nFor more information about IAM roles, see [IAM basic and predefined roles reference](/iam/docs/understanding-roles) and [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\u003cbr /\u003e\n\nList the recommendations\n------------------------\n\nTo list the recommendations, follow these steps: \n\n### Console\n\nTo list recommendations about instance performance, follow these steps:\n\n1. Go to the **Cloud SQL Instances** page.\n\n[Go to Cloud SQL Instances](https://console.cloud.google.com/sql/instances)\n\n1. On the **Improve instance health by investigating issues and acting on\n recommendations** banner, click **Expand Details** .\n\nAlternatively, follow these steps:\n\n1. Go to the **Recommendation Hub** . See also [Find and apply recommendations with the Recommendations](/recommender/docs/recommendation-hub/identify-configuration-problems).\n\n [Go to the Recommendation Hub](https://console.cloud.google.com/home/recommendations/)\n2. In the **All recommendations** card, click **Performance** .\n\n### gcloud\n\nRun the [`gcloud recommender recommendations list`](/sdk/gcloud/reference/recommender/recommendations/list) command as follows: \n\n```\ngcloud recommender recommendations list \\\n--project=PROJECT_ID \\\n--location=LOCATION \\\n--recommender=google.cloudsql.instance.PerformanceRecommender \\\n--filter=recommenderSubtype=MYSQL_RECONFIG_OPEN_TABLES\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: your project ID\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: a region where your instances are located, such as `us-central1`\n\n### API\n\nCall the [`recommendations.list`](/recommender/docs/reference/rest/v1/projects.locations.recommenders.recommendations/list) method as follows: \n\n```\nGET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: your project ID\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: a region where your instances are located, such as `us-central1`\n\nView insights and detailed recommendations\n------------------------------------------\n\nTo view insights and detailed recommendations, follow these steps: \n\n### Console\n\nDo one of the following:\n\n- On the **Performance Recommendations** page, click the **Performance\n recommendations** card and then click **Manage open tables**. The\n recommendation panel appears, which contains insights and detailed\n recommendations for the instance.\n\n- On the **Instances** page, click **Manage open tables**.\n The list of instances displays only those instances for which the\n recommendation applies.\n\n### gcloud\n\nRun the [`gcloud recommender insights list`](/sdk/gcloud/reference/recommender/insights/list) command as follows: \n\n```\n\ngcloud recommender insights list \\\n--project=PROJECT_ID \\\n--location=LOCATION \\\n--insight-type=google.cloudsql.instance.PerformanceInsight \\\n--filter=insightSubtype=INSIGHT_SUBTYPE\n\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: your project ID\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: a region where your instances are located, such as `us-central1`\n- \u003cvar translate=\"no\"\u003eINSIGHT_SUBTYPE\u003c/var\u003e: set this parameter to one of the following:\n - `MYSQL_HIGH_NUMBER_OF_OPEN_TABLES`: display insights for the number of open tables for your instance\n - `MYSQL_HIGH_NUMBER_OF_OPEN_TABLE_DEFINITIONS`: display insights for the number of open table definitions for your instance\n\n### API\n\nCall the [`insights.list`](/recommender/docs/reference/rest/v1/projects.locations.insightTypes.insights/list) method as follows: \n\n```\n\nGET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.cloudsql.instance.PerformanceInsight/insights\n\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: your project ID\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: a region where your instances are located, such as `us-central1`\n\nApply the recommendation\n------------------------\n\nTo implement this recommendation, do one of the following:\n\n- For a high number of open tables, increase the value of `table_open_cache` by\n 500 until the recommendation disappears.\n\n- For a high number of open table definitions, increase the value of\n `table_definition_cache` by 500 until the recommendation disappears.\n\n| **Note:** Increasing `table_open_cache` or`table_definition_cache` requires more memory. After increasing these flags, monitor the memory usage .\n\nThis recommendation is updated daily, so after you increase the value of either\n`table_open_cache` or `table_definition_cache`, wait for 24 hours before\nchecking the recommendation again. For more information on increasing the value\nof `table_open_cache` and `table_definition_cache`, see [Table limit](/sql/docs/quotas#table_limit).\n\nWhat's next\n-----------\n\n- [Google Cloud recommenders](/recommender/docs/recommenders)"]]
