Configura la agrupación de conexiones administrada

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 sea 515.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

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. 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.

  3. Haz clic en Editar.

  4. En Personaliza tu instancia, expande Conexiones.

  5. Para habilitar el grupo de conexiones administrado, marca la casilla Habilitar el grupo de conexiones administrado.

  6. 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

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. 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.

  3. Haz clic en Editar.

  4. En Personaliza tu instancia, expande Conexiones.

  5. En Grupo de conexiones administrado, expande Opciones de grupo de conexiones avanzadas.

    Modifica las opciones de agrupación disponibles que deseas actualizar.

  6. 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

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. 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.

  3. Haz clic en Editar.

  4. En Personaliza tu instancia, expande Conexiones.

  5. Para inhabilitar el grupo de conexiones administrado, borra la casilla de verificación Habilitar el grupo de conexiones administrado.

  6. 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

  1. En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. 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:

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:

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:
  • idle: Es la cantidad de subprocesos inactivos en el grupo.
  • active: Es la cantidad de subprocesos activos (no inactivos) en el grupo.
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?