Se usó la API de Cloud Translation para traducir esta página.

Configura la agrupación de conexiones administrada

MySQL | PostgreSQL | SQL Server

Vista previa — Managed Connection Pooling

Esta función está sujeta a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del Servicio Generales de las Condiciones Específicas del Servicio. Puedes procesar datos personales para esta función, como se describe en el Anexo de Tratamiento de Datos de Cloud, sujeto a las obligaciones y restricciones que se describen en el acuerdo en virtud del cual accedes a Google Cloud. Las funciones de la fase previa a la DG están disponibles "sin modificaciones" y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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 la agrupación de conexiones administradas.
Si usas la CLI de gcloud, usa el comando gcloud beta y confirma que tu versión de la CLI de gcloud sea 515.0.0 o posterior.
Confirma que tu instancia esté usando la nueva arquitectura de red de Cloud SQL. Si tu instancia aún usa la arquitectura de red anterior, actualízala a la nueva arquitectura de red.

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 la reducción de conexión administrada habilitada, consulta Crea instancias. Puedes habilitar la agrupación de conexiones administradas para una instancia con gcloud CLI o la API de Cloud SQL.

Habilita el grupo de conexiones administrado para una instancia existente

Puedes habilitar el agrupamiento de conexiones administradas para una instancia existente con laGoogle Cloud consola, la CLI de gcloud o la API de Cloud SQL. Debes habilitar la agrupación de conexiones administrada antes de modificar las opciones de la agrupación de conexiones administrada.

Console

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

Ir a Instancias de Cloud SQL
Busca la instancia para la que deseas habilitar la reducción de conexiones administrada. Para abrir la página Resumen 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 de verificación Habilitar el grupo de conexiones administrado.
Haz clic en Guardar.

Nota: Esto hará que se reinicie la instancia.

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: Es 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 administradas en una instancia existente, usa el siguiente comando y configura 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:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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 administradas en una instancia existente, usa el siguiente comando y configura 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:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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"
}

Terraform

Para habilitar el grupo de conexiones administrado en una instancia existente, usa el siguiente recurso de Terraform:

resource "google_sql_database_instance" "postgres_managed_connection_pooling_enable" {
  name                = "postgres-instance-managed-connection-pooling-enable"
  region              = "us-central1"
  database_version    = "POSTGRES_16"
  deletion_protection = false

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    connection_pool_config {
      connection_pooling_enabled = true # Set to true here
    }
  }
}

Cómo modificar la agrupación de conexiones administrada para una instancia

Después de habilitar la agrupación de conexiones administrada, puedes personalizarla con las opciones de configuración disponibles. Estas opciones de configuración se denominan marcas de grupo de Managed Connection Pooling. Las configuraciones agregadas a la agrupación de conexiones administrada se aplican a todos los agrupadores que usa la instancia. Para obtener más información sobre las opciones de configuración disponibles, sus valores predeterminados y rangos, consulta Opciones de configuración disponibles.

Para modificar las opciones de configuración disponibles del grupo de conexiones administrado para una instancia, haz lo siguiente:

Console

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

Ir a Instancias de Cloud SQL
Busca la instancia para la que deseas habilitar la reducción de conexiones administrada. Para abrir la página Resumen 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 avanzadas de agrupación.

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 la agrupación de conexiones administradas.
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: Es el valor nuevo para la opción de configuración que seleccionaste.

REST v1

Para modificar la configuración disponible de la agrupación de conexiones administradas, 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:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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 la configuración disponible de la agrupación de conexiones administradas, 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:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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"
}

Terraform

Para modificar las configuraciones disponibles de la agrupación de conexiones administradas, usa el siguiente recurso de Terraform:

resource "google_sql_database_instance" "postgres_managed_connection_pooling_modify" {
  name                = "postgres-instance-managed-connection-pooling-modify"
  region              = "us-central1"
  database_version    = "POSTGRES_16"
  deletion_protection = false

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    connection_pool_config {
      connection_pooling_enabled = true
      flags {
        name  = "max_pool_size" # Modify the value of an existing flag
        value = "10"
      }
    }
  }
}

Inhabilita la agrupación de conexiones administrada para una instancia

Puedes inhabilitar el agrupamiento de conexiones administradas para una instancia existente con laGoogle Cloud consola, la CLI de gcloud o la API de Cloud SQL.

Para inhabilitar la reducción de conexión administrada en una instancia, haz lo siguiente:

Console

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

Ir a Instancias de Cloud SQL
Busca la instancia para la que deseas inhabilitar la reducción de conexión administrada. Para abrir la página Resumen de la instancia, haz clic en su nombre.
Haz clic en Editar.
En Personaliza tu instancia, expande Conexiones.
Para inhabilitar la agrupación de conexiones administradas, desmarca la casilla de Habilitar el grupo de conexiones administrado.
Haz clic en Guardar.

Nota: Esto hará que se reinicie la instancia.

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: Es el nombre de la instancia de Cloud SQL para la que deseas inhabilitar la agrupación de conexiones administradas.

REST v1

Para inhabilitar el grupo de conexiones administradas para una instancia, usa el siguiente comando y configura 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:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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 administradas para una instancia, usa el siguiente comando y configura 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:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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"
}

Terraform

Para inhabilitar el agrupamiento de conexiones administradas para una instancia, usa el siguiente recurso de Terraform:

resource "google_sql_database_instance" "postgres_managed_connection_pooling_disable" {
  name                = "postgres-instance-managed-connection-pooling-disable"
  region              = "us-central1"
  database_version    = "POSTGRES_16"
  deletion_protection = false

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    connection_pool_config {
      # Set to false to disable Managed Connection Pooling. You can also remove the block entirely.
      connection_pooling_enabled = false
    }
  }
}

Consulta el estado de la agrupación de conexiones administrada para una instancia

Puedes ver el estado de la agrupación de conexiones administradas para una instancia con la Google Cloud consola, la CLI de gcloud o la API de Cloud SQL.

Para ver el estado de la agrupación de conexiones administradas de una instancia de la edición Enterprise Plus de Cloud SQL, haz lo siguiente:

Console

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

Ir a Instancias de Cloud SQL
Busca la instancia para la que deseas ver el estado de la reducción de conexión administrada. Para abrir la página Resumen 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
  --format="value(settings.connectionPoolConfig.connectionPoolingEnabled)"

Reemplaza lo siguiente:

PROJECT_ID: Es el nombre de la instancia de Cloud SQL para la que deseas ver el estado de la agrupación de conexiones administradas.

Si la agrupación de conexiones administrada está habilitada, se muestra la siguiente respuesta:

connectionPoolingEnabled: true

REST v1

Para ver el estado de la agrupación de conexiones administradas de tu instancia de Cloud SQL, usa el siguiente comando y busca connectionPoolingEnabled:

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID o el número del proyecto del proyecto 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:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
  "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 de la agrupación de conexiones administradas de tu instancia de Cloud SQL, usa el siguiente comando y busca connectionPoolingEnabled:

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

PROJECT_ID: Es el ID o el número del proyecto del proyecto 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:

curl (Linux, macOS o Cloud Shell)

Ejecuta el siguiente comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "POSTGRES_13",
  "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 la agrupación de conexiones administrada

Puedes supervisar el funcionamiento de la agrupación de conexiones administradas en tus instancias de Cloud SQL con las siguientes métricas de la agrupación de conexiones administradas de Cloud SQL:

Nombre de la métrica	Descripción
num_pools	Es la cantidad total de grupos de conexiones por base de datos.
client_connection	Realiza un seguimiento del recuento de conexiones según el estado de la conexión del cliente. Los estados incluidos en esta métrica son los siguientes: `active`: Es la cantidad de conexiones activas por base de datos, incluidos los clientes inactivos que no tienen solicitudes de consultas pendientes. `waiting`: Es la cantidad de clientes que esperan una conexión del servidor por base de datos.
server_connections	Realiza un seguimiento del recuento de conexiones del servidor según el estado de la conexión del servidor. Los estados incluidos en esta métrica son los siguientes: `active`: Es la cantidad de conexiones activas por base de datos. `waiting`: Es la cantidad de conexiones inactivas del servidor por base de datos.
client_connections_avg_wait_time	Es el tiempo promedio que todos los clientes pasan en estado de espera para 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.

Configura la agrupación de conexiones administrada Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Antes de comenzar

Habilita el grupo de conexiones administrado para una instancia nueva

Habilita el grupo de conexiones administrado para una instancia existente

Console

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Terraform

Cómo modificar la agrupación de conexiones administrada para una instancia

Console

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Terraform

Inhabilita la agrupación de conexiones administrada para una instancia

Console

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Terraform

Consulta el estado de la agrupación de conexiones administrada para una instancia

Console

gcloud

REST v1

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS o Cloud Shell)

PowerShell (Windows)

Supervisa la agrupación de conexiones administrada

¿Qué sigue?

Configura la agrupación de conexiones administrada