En esta página, se describe cómo configurar el grupo de conexiones administrado para tus instancias de Cloud SQL.
Antes de comenzar
- Confirma que tu instancia cumpla con todos los requisitos para usar el grupo de conexiones administrado.
- Si usas gcloud CLI, usa el comando
gcloud beta
y confirma que la versión de gcloud CLI sea515.0.0
o una posterior.
Puedes habilitar el grupo de conexiones administrado para una instancia en el momento de la creación o editar una instancia existente para habilitarlo.
Habilita el grupo de conexiones administrado para una instancia nueva
Para crear una instancia con el grupo de conexiones administrado habilitado, consulta Cómo crear instancias. Puedes habilitar el grupo de conexiones administrado para una instancia con gcloud CLI o la API de Cloud SQL.
Habilita la agrupación de conexiones administradas para una instancia existente
Puedes habilitar el grupo de conexiones administrado para una instancia existente con la consola de Google Cloud, gcloud CLI o la API de Cloud SQL. Debes habilitar el grupo de conexiones administrado antes de modificar sus opciones.
Console
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
Busca la instancia para la que deseas habilitar el grupo de conexiones administrado. Para abrir la página Descripción general de la instancia, haz clic en su nombre.
Haz clic en Editar.
En Personaliza tu instancia, expande Conexiones.
Para habilitar el grupo de conexiones administrado, marca la casilla Habilitar el grupo de conexiones administrado.
Haz clic en Guardar.
gcloud
Usa el comando gcloud beta sql instances
para habilitar el grupo de conexiones administrado.
gcloud beta sql instances patch INSTANCE_NAME \
--enable-connection-pooling
Reemplaza lo siguiente:
INSTANCE_NAME
: El nombre de la instancia de Cloud SQL para la que deseas habilitar el grupo de conexiones administrado.
REST v1
Para habilitar el grupo de conexiones administrado para una instancia existente, usa el siguiente
comando y establece connectionPoolingEnabled
:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: el ID del proyecto
- INSTANCE_ID: El ID de la instancia
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": true } } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
REST v1beta4
Para habilitar el grupo de conexiones administrado para una instancia existente, usa el siguiente
comando y establece connectionPoolingEnabled
:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: el ID del proyecto
- INSTANCE_ID: El ID de la instancia
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": true } } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
Modifica la agrupación de conexiones administrada para una instancia
Después de habilitar el grupo de conexiones administrado, puedes personalizarlo con las opciones de configuración disponibles. Estas opciones de configuración se denominan marcas de grupo de grupos de conexiones administrados. Las configuraciones que se agregan al grupo de conexiones administrado se aplican a todos los grupos de conexiones que usa la instancia. Para obtener más información sobre las opciones de configuración disponibles, sus valores predeterminados y sus rangos, consulta las opciones de configuración disponibles.
Para modificar las opciones de configuración disponibles del grupo de conexiones administrado de una instancia, haz lo siguiente:
Console
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
Busca la instancia para la que deseas habilitar el grupo de conexiones administrado. Para abrir la página Descripción general de la instancia, haz clic en su nombre.
Haz clic en Editar.
En Personaliza tu instancia, expande Conexiones.
En Grupo de conexiones administrado, expande Opciones de grupo de conexiones avanzadas.
Modifica las opciones de agrupación disponibles que deseas actualizar.
Haz clic en Guardar.
gcloud
Usa el comando gcloud beta sql instances
para modificar las opciones de configuración.
gcloud beta sql instances patch INSTANCE_NAME \
--connection-pool-flags=CONFIGURATION_NAME=CONFIGURATION_VALUE
Reemplaza lo siguiente:
INSTANCE_NAME
: Es el nombre de la instancia de Cloud SQL para la que deseas modificar el grupo de conexiones administrado.CONFIGURATION_NAME
: Es el nombre de la opción de configuración que deseas modificar. Para obtener una lista de todas las opciones de configuración disponibles, consulta opciones de configuración disponibles.CONFIGURATION_VALUE
: El valor nuevo de la opción de configuración que seleccionaste.
REST v1
Para modificar las configuraciones disponibles del grupo de conexiones administrado, usa el siguiente comando y establece ConnectionPoolConfig
:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: el ID del proyecto
- INSTANCE_ID: El ID de la instancia
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "connectionPoolConfig": { "flags": [ { "name": "CONFIGURATION_NAME", "value":"CONFIGURATION_VALUE" } ] } } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
REST v1beta4
Para modificar las configuraciones disponibles del grupo de conexiones administrado, usa el siguiente comando y establece ConnectionPoolConfig
:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: el ID del proyecto
- INSTANCE_ID: El ID de la instancia
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "connectionPoolConfig": { "flags": [ { "name": "CONFIGURATION_NAME", "value":"CONFIGURATION_VALUE" } ] } } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
Inhabilita la agrupación de conexiones administradas para una instancia
Puedes inhabilitar el grupo de conexiones administrado para una instancia existente con la consola de Google Cloud, gcloud CLI o la API de Cloud SQL.
Para inhabilitar el grupo de conexiones administrado para una instancia, haz lo siguiente:
Console
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
Busca la instancia para la que deseas inhabilitar el grupo de conexiones administrado. Para abrir la página Descripción general de la instancia, haz clic en su nombre.
Haz clic en Editar.
En Personaliza tu instancia, expande Conexiones.
Para inhabilitar el grupo de conexiones administrado, borra la casilla de verificación Habilitar el grupo de conexiones administrado.
Haz clic en Guardar.
gcloud
Usa el comando gcloud beta sql instances
para inhabilitar el grupo de conexiones administrado.
gcloud beta sql instances patch INSTANCE_NAME \
--no-enable-connection-pooling
Reemplaza lo siguiente:
PROJECT_ID
: El nombre de la instancia de Cloud SQL para la que deseas inhabilitar el grupo de conexiones administrado.
REST v1
Para inhabilitar el grupo de conexiones administrado para una instancia, usa el siguiente
comando y establece connectionPoolingEnabled
:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: el ID del proyecto
- INSTANCE_ID: El ID de la instancia
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": false } } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
REST v1beta4
Para inhabilitar el grupo de conexiones administrado para una instancia, usa el siguiente
comando y establece connectionPoolingEnabled
:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: el ID del proyecto
- INSTANCE_ID: El ID de la instancia
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": false } } }
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-16T02:32:12.281Z", "operationType": "UPDATE", "name": "OPERATION_ID", "targetId": "INSTANCE_ID", "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID", "targetProject": "PROJECT_ID" }
Consulta el estado del grupo de conexiones administrado de una instancia
Puedes ver el estado del grupo de conexiones administrado de una instancia con la consola de Google Cloud, gcloud CLI o la API de Cloud SQL.
Para ver el estado del grupo de conexiones administrado de una instancia de la edición de Cloud SQL Enterprise Plus, haz lo siguiente:
Console
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
Busca la instancia para la que deseas inhabilitar el grupo de conexiones administrado. Para abrir la página Descripción general de la instancia, haz clic en su nombre.
En la sección Conexiones, se muestra si el grupo de conexiones administrado está habilitado o inhabilitado.
gcloud
gcloud beta sql instances describe INSTANCE_NAME| 2 connectionPoolingEnabled
Reemplaza lo siguiente:
PROJECT_ID
: Es el nombre de la instancia de Cloud SQL para la que deseas ver el estado del grupo de conexiones administrado.Si el grupo de conexiones administrado está habilitado, se muestra la siguiente respuesta:
connectionPoolingEnabled: true
REST v1
Para ver el estado del grupo de conexiones administrado de tu instancia de Cloud SQL, usa el siguiente comando y busca ConnectPoolingEnabled
:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL. Si esta instancia tiene Private Service Connect habilitado para ella, los extremos de Private Service Connect en las redes de VPC pueden conectarse a ella.
HTTP method and URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "MYSQL_8_0", "settings": { "authorizedGaeApplications": [], "tier": "db-custom-2-7680", "kind": "sql#settings", "availabilityType": "REGIONAL", "pricingPlan": "PER_USE", "replicationType": "SYNCHRONOUS", "activationPolicy": "ALWAYS", "ipConfiguration": { "authorizedNetworks": [], "pscConfig": { "allowedConsumerProjects": [ "ALLOWED_PROJECTS" ], "pscEnabled": true }, "ipv4Enabled": false }, ... "createTime": "2023-06-14T18:48:34.975Z", "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE", "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID", "dnsName": "DNS_NAME" }
REST v1beta4
Para ver el estado del grupo de conexiones administrado de tu instancia de Cloud SQL, usa el siguiente comando y busca ConnectPoolingEnabled
:
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: el ID o el número del proyecto de Google Cloud que contiene la instancia.
- INSTANCE_NAME: el nombre de la instancia de Cloud SQL. Si esta instancia tiene Private Service Connect habilitado para ella, los extremos de Private Service Connect en las redes de VPC pueden conectarse a ella.
HTTP method and URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Para enviar tu solicitud, expande una de estas opciones:
Deberías recibir una respuesta JSON similar a la que se muestra a continuación:
{ "kind": "sql#instance", "state": "RUNNABLE", "databaseVersion": "MYSQL_8_0", "settings": { "authorizedGaeApplications": [], "tier": "db-custom-2-7680", "kind": "sql#settings", "availabilityType": "REGIONAL", "pricingPlan": "PER_USE", "replicationType": "SYNCHRONOUS", "activationPolicy": "ALWAYS", "ipConfiguration": { "authorizedNetworks": [], "pscConfig": { "allowedConsumerProjects": [ "ALLOWED_PROJECTS" ], "pscEnabled": true }, "ipv4Enabled": false }, ... "createTime": "2023-06-14T18:48:34.975Z", "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE", "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID", "dnsName": "DNS_NAME" }
Supervisa el grupo de conexiones administrado
Puedes supervisar cómo se ejecuta el grupo de conexiones administrado en tus instancias de Cloud SQL con las siguientes métricas del grupo de conexiones administrado de Cloud SQL:
Nombre de la métrica | Descripción |
---|---|
subprocesos | Hace un seguimiento del recuento de subprocesos en el grupo de conexiones según su estado. Los estados incluidos en esta métrica son los siguientes:
|
pending_connection | Es la cantidad de conexiones activas en la fila de agrupación. |
avg_wait_time | Es el tiempo promedio que la solicitud de conexión pasa esperando un servidor. |
Para obtener más información sobre estas métricas, consulta Métricas de Cloud SQL. Para ver estas métricas con la consola de Google Cloud, consulta Visualiza las métricas en la página de descripción general de la instancia de Cloud SQL.
¿Qué sigue?
- Visualiza las métricas en la página de descripción general de la instancia de Cloud SQL
- Descripción general del grupo de conexiones administrado