Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
MySQL | PostgreSQL | SQL Server
En esta página, se describe cómo administrar bases de datos con una gran cantidad de conexiones de clientes simultáneas y una gran cantidad de subprocesos de conexión de base de datos. Este recomendador se llama Reconfigura la configuración de conexión.
Todos los días, este recomendador analiza las métricas de los siguientes aspectos:
La cantidad máxima de conexiones de bases de datos mediante el seguimiento del valor de la marca max_used_connections. Si el número máximo de conexiones desde que se reinició el servidor es el 80% del valor max_connections, Reconfigura la configuración de conexión recomienda que aumentes el valor de max_connections.
Es la cantidad de subprocesos de conexión de base de datos nuevos en comparación con la cantidad de subprocesos de conexión de base de datos existentes. Si más del 50% de las conexiones dan como resultado subprocesos nuevos en lugar de volver a usar subprocesos almacenados en caché, o si el valor de thread_cache_size se establece en 0, Reconfigura la configuración de conexión recomienda que aumentes el valor de thread_cache_size.
En el banner Mejora el estado de la instancia mediante la investigación de problemas y la acción de las recomendaciones, haz clic en Expandir detalles.
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/recommenders/google.cloudsql.instance.PerformanceRecommender/recommendations
Reemplaza lo siguiente:
PROJECT_ID: el ID de tu proyecto
LOCATION: una región en la que se encuentran las instancias, como us-central1.
Visualiza las estadísticas y las recomendaciones detalladas
Para visualizar estadísticas y recomendaciones detalladas, sigue estos pasos:
Console
Realiza una de las siguientes acciones:
En la página Recomendaciones de rendimiento, haz clic en la tarjeta Recomendaciones de rendimiento y, luego, en Reconfigura la conexión.
Aparecerá el panel de recomendaciones, que contiene estadísticas y recomendaciones
detalladas para la instancia.
En la página Instancias, haz clic en Reconfigura la configuración de conexión.
La lista de instancias muestra solo aquellas para las que se aplica la recomendación.
LOCATION: una región en la que se encuentran las instancias, como us-central1.
INSIGHT_SUBTYPE: establece este parámetro en una de las siguientes opciones:
MYSQL_HIGH_NUMER_OF_CONNECTIONS: Muestra estadísticas sobre la cantidad de conexiones de bases de datos de tu instancia.
MYSQL_HIGH_THREAD_CACHE_MISS_RATE: muestra estadísticas sobre la cantidad de subprocesos de conexión de la base de datos nuevos sin usar la caché de subprocesos de tu instancia.
API
Llama al método insights.list de la siguiente manera:
GET https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/google.cloudsql.instance.PerformanceInsight/insights
Reemplaza lo siguiente:
PROJECT_ID: el ID de tu proyecto
LOCATION: una región en la que se encuentran las instancias, como us-central1.
Aplica la recomendación
Para implementar esta recomendación, haz una de las siguientes acciones:
Para aplicar la recomendación del tamaño de la caché del subproceso de conexión, realiza una de las siguientes acciones:
Si el valor de thread_cache_size se establece en 0, habilita la caché de subprocesos mediante la configuración de esta marca en un valor mayor que 0.
Si el valor de thread_cache_size es mayor que 0, aumenta el valor de esta marca. thread_cache_size debe ser equivalente a la cantidad promedio de conexiones a la base de datos. Aumenta el valor de thread_cache_size si la cantidad de subprocesos nuevos es mayor que la configuración actual.
Para aplicar la recomendación de conexión de la base de datos, aumenta el valor de la marca max_connections. La recomendación se actualiza a diario, por lo que, después de aumentar el valor de esta marca, espera 24 horas antes de volver a verificar la recomendación. Para obtener más información sobre cómo aumentar el valor de max_connections, consulta Cantidad máxima de conexiones simultáneas.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-09-04 (UTC)"],[],[],null,["# Reconfigure connection settings\n\n\u003cbr /\u003e\n\nMySQL \\| PostgreSQL \\| SQL Server\n\n\u003cbr /\u003e\n\n|\n| **Preview**\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 databases with a high number of simultaneous\nclient connections and a high number of database connection threads. This\n[recommender](/recommender/docs/recommenders) is called\n**Reconfigure connection settings**.\n\nEvery day, this recommender analyzes metrics for the following:\n\n- The peak number of database connections by tracking the value of\n the `max_used_connections` flag. If the maximum number of connections since\n the server restarted is 80% of the value `max_connections`, **Reconfigure\n connection settings** recommends that you increase the value of\n `max_connections` .\n\n For more information on increasing the value of `max_connections`, see\n [Maximum concurrent connections](/sql/docs/quotas#maximum_concurrent_connections).\n- The number of new database connection threads compared to the number of\n existing database connection threads. If more than 50% of connections result\n in new threads instead of reusing cached ones, or if the value of\n `thread_cache_size` is set to 0, then **Reconfigure connection settings**\n recommends that you increase the value of `thread_cache_size`.\n\n For more information on increasing the value of `max_connections`, see\n [Optimize high CPU utilization in instances](/sql/docs/mysql/optimize-cpu-usage).\n This feature is in [Preview](/products#product-launch-stages).\n\nPricing\n-------\n\nThe **Reconfigure connection settings** 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_CONNECTIONS\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 **Reconfigure connection settings**.\n The recommendation panel appears, which contains insights and detailed\n recommendations for the instance.\n\n- On the **Instances** page, click **Reconfigure connection settings**.\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_NUMER_OF_CONNECTIONS`: display insights for the number of database connections for your instance\n - `MYSQL_HIGH_THREAD_CACHE_MISS_RATE`: display insights for the number of new database connection threads without using the thread cache 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- To apply the recommendation for the connection thread cache size, do one of\n the following:\n\n - If the value of `thread_cache_size` is set to 0, then enable the thread\n cache by setting this flag to a value greater than 0.\n\n - If the value of `thread_cache_size` is greater than 0, then increase the\n value of this flag. `thread_cache_size` should be equivalent to the average\n number of connections to the database. Increase the value of\n `thread_cache_size` if the number of new threads is higher than the current\n setting.\n\n- To apply the database connection recommendation, increase the value of the\n `max_connections` flag. The recommendation is updated daily, so after you\n increase the value of this flag, wait for 24 hours before checking the recommendation again. For more information on\n increasing the value of `max_connections`, see [Maximum concurrent connections](/sql/docs/quotas#maximum_concurrent_connections).\n\n| **Note:** Increasing `thread_cache_size` and `max_connections` requires more memory. After increasing these flags, monitor the memory usage.\n\nWhat's next\n-----------\n\n- [Google Cloud recommenders](/recommender/docs/recommenders)"]]
