Configura la agrupación de conexiones administradas

Para escalar tus cargas de trabajo de AlloyDB para PostgreSQL, absorber los aumentos repentinos de conexiones y reducir la latencia de las conexiones, puedes habilitar la agrupación de conexiones administrada. La agrupación de conexiones administrada mantiene un grupo de conexiones de servidor preestablecidas y multiplexa de forma dinámica las solicitudes entrantes de los clientes en esas conexiones, en lugar de abrir y cerrar una conexión de backend para cada operación de la base de datos.

En lugar de conectarte directamente al backend de la base de datos, tu aplicación se conecta a un agrupador, que proporciona tiempos de conexión más cortos y una escalabilidad mejorada para tus cargas de trabajo de lectura y escritura. Si bien puedes usar la agrupación de conexiones administradas para cualquier carga de trabajo transaccional, es más adecuada para las aplicaciones que usan conexiones de corta duración o que experimentan aumentos repentinos de conexiones.

Nota: La agrupación de conexiones administrada está inhabilitada de forma predeterminada.

Antes de comenzar

La agrupación de conexiones administrada también admite conexiones con el proxy de autenticación de AlloyDB o los conectores de lenguajes para AlloyDB.

Roles obligatorios

Para obtener el permiso que necesitas para habilitar y usar la agrupación de conexiones administrada, pídele a tu administrador que te otorgue el rol de IAM de Administrador de AlloyDB (roles/alloydb.admin) en la instancia de AlloyDB. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene el permiso alloydb.instances.update, que se requiere para habilitar y usar la agrupación de conexiones administradas.

También puedes obtener este permiso con roles personalizados o con otros roles predefinidos.

Opciones de configuración avanzada

La agrupación de conexiones administrada de AlloyDB admite las siguientes opciones de configuración de agrupación avanzada. Puedes personalizar la agrupación de conexiones administradas para satisfacer las necesidades de tu instancia. Para ello, establece estos parámetros de configuración a nivel de la instancia con la consola de Google Cloud , gcloud CLI o la API de AlloyDB.

Nombre de la configuración	Descripción
Modo de conexión (connection-pooling-pool-mode)	Para el modo de conexión, puedes seleccionar transacción (predeterminado) o sesión. Transacción (transaction): Agrupa las conexiones a nivel de transacción. Se asigna una conexión de servidor a un cliente durante una transacción. Una vez que se completa la transacción, la conexión del servidor se vuelve a colocar en el grupo. Sesión (session): Agrupa las conexiones a nivel de sesión. Se asigna una conexión de servidor al cliente durante todo el tiempo que permanece conectado. Después de que el cliente se desconecta, la conexión del servidor se vuelve a colocar en el grupo.
Tamaño máximo del grupo (connection-pooling-max-pool-size)	Es el tamaño máximo del grupo de conexiones por par de usuario y base de datos. Este valor puede variar de 1 a 262,042 conexiones, y el valor predeterminado es 50 conexiones.
Tamaño mínimo del grupo (connection-pooling-min-pool-size)	Es el tamaño mínimo del grupo de conexiones. Este valor puede variar de 0 a 262,042 conexiones, y el valor predeterminado es 0 conexiones.
Cantidad máxima de conexiones de cliente (connection-pooling-max-client-connections)	Es la cantidad máxima de conexiones simultáneas de clientes permitidas. Este valor puede variar de 1 a 262,042 conexiones, y el valor predeterminado es 5000 conexiones.
Tiempo de espera de la conexión de cliente inactiva(s) (connection-pooling-client-connection-idle-timeout)	Es el tiempo que una conexión de cliente permanece inactiva antes de que se agote el tiempo de espera. Este valor puede variar de 0 a 2,147,483 segundos, y el valor predeterminado es 0 segundos.
Tiempo de espera de la conexión del servidor inactivo(s) (connection-pooling-server-idle-timeout)	Es el tiempo que una conexión de servidor permanece inactiva antes de que se agote el tiempo de espera. Este valor puede variar de 0 a 2,147,483 segundos, y el valor predeterminado es 600 segundos.
Tiempo de espera de la consulta(s) (connection-pooling-query-wait-timeout)	Es el tiempo que espera una consulta hasta que se agota el tiempo de espera. Este valor puede variar de 0 a 2,147,483 segundos, y el valor predeterminado es 120 segundos.
Cantidad máxima de instrucciones preparadas (connection-pooling-max-prepared-statements)	Es la cantidad máxima de comandos de instrucciones preparadas que se envían en el modo de agrupación de transacciones. Este valor puede variar de 0 a 262,042, y el valor predeterminado es 0.
Ignorar parámetros de inicio (connection-pooling-ignore-startup-parameters)	Es una lista separada por comas de parámetros de inicio que el agrupador ignora cuando no se hace un seguimiento de ellos en los paquetes de inicio de forma predeterminada. El valor predeterminado es extra_float_digits.
Duración del servidor(s) (connection-pooling-server-lifetime)	Es el tiempo máximo que una conexión de servidor no se usa antes de que la agrupación de conexiones administrada la cierre. Este valor puede variar de 0 a 2,147,483 segundos, y el valor predeterminado es 3600 segundos.
Usuarios de estadísticas (connection-pooling-stats-users)	Es una lista separada por comas de los usuarios de la base de datos autorizados para conectarse a la consola de estadísticas. Este parámetro se puede configurar con Google Cloud CLI o la API de AlloyDB. Los usuarios autorizados pueden acceder a las métricas avanzadas, que se mantienen en la base de datos alloydb_mcp_stats_{pooler_id} para cada agrupador.

De forma predeterminada, la agrupación de conexiones administrada inicia conexiones con el servidor de AlloyDB. Cuando se establece y autentica una conexión de cliente, la agrupación de conexiones administrada puede crear una o más conexiones de servidor para que el tamaño del grupo coincida con la configuración elegida. Luego, se asigna una conexión de servidor disponible a la conexión del cliente. Las conexiones del servidor se mantienen hasta que se cierran de forma explícita o están inactivas durante un período superior al tiempo de espera de la conexión del servidor inactiva.

Cuando habilitas la agrupación de conexiones administrada, las conexiones del servidor proxy de autenticación de AlloyDB también se agrupan en un grupo independiente que solo incluye conexiones agrupadas con el proxy de autenticación de AlloyDB habilitado.

Habilita la agrupación de conexiones administradas

Nota: Para habilitar la agrupación de conexiones administrada en las instancias de AlloyDB creadas antes de noviembre de 2024, se requiere una actualización única de la configuración de red. Esta actualización genera una breve interrupción en la conectividad de red de VPC, que suele durar menos de 15 segundos. La IP pública no se ve afectada. La base de datos no se reiniciará durante este proceso.

Puedes habilitar la agrupación de conexiones administradas para cualquier instancia existente o nueva.

Habilita para una instancia principal nueva

Para crear una instancia principal nueva con la agrupación de conexiones administrada habilitada, consulta Crea una instancia principal. Puedes habilitar la agrupación de conexiones administradas para una instancia con la consola deGoogle Cloud , Google Cloud CLI o la API de AlloyDB.

Habilita para una instancia de grupo de lectura nueva

Para crear una instancia de grupo de lectura nueva con la agrupación de conexiones administradas habilitada, consulta Crea una instancia de grupo de lectura. Puedes habilitar la agrupación de conexiones administradas para una instancia con la consola deGoogle Cloud , Google Cloud CLI o la API de AlloyDB.

Habilita para una instancia existente

Puedes habilitar la agrupación de conexiones administrada para una instancia existente con la consola deGoogle Cloud , Google Cloud CLI o la API de AlloyDB.

Console

1. Ve a la página Clústeres.

   Ir a los clústeres

2. Haz clic en un clúster en la columna Nombre del recurso.

3. En la página Descripción general, navega a Instancias en tu clúster.

4. Haz clic en Editar instancia principal o Editar grupo de lectura.

5. En Grupo de conexiones administradas, selecciona la casilla de verificación Habilitar el grupo de conexiones administradas.

6. Opcional: Para configurar las opciones de agrupación de conexiones administradas, haz clic en Opciones avanzadas de agrupación.

   Puedes personalizar las opciones de agrupación de conexiones administradas para satisfacer las necesidades de tu instancia. Para obtener más información, consulta Opciones de configuración avanzada.

7. Haz clic en Guardar cambios.

gcloud

Para habilitar la agrupación de conexiones administrada en una instancia de grupo principal o de lectura existente, usa el siguiente comando de gcloud alloydb instances update:

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --enable-connection-pooling

Reemplaza lo siguiente:

• INSTANCE_ID: Es el ID de la instancia de AlloyDB para la que deseas habilitar la agrupación de conexiones administrada.
• PROJECT_ID: el ID del proyecto
• REGION_ID: Es el ID de la región.
• CLUSTER_ID: Es el ID del clúster.

Después de habilitar la agrupación de conexiones administradas, puedes personalizar las opciones de agrupación de conexiones administradas para satisfacer las necesidades de tu instancia configurando las opciones de configuración avanzadas. Para obtener más información sobre cómo establecer las opciones de configuración, consulta Modifica la reducción de conexiones administradas para una instancia.

REST

Para habilitar la agrupación de conexiones administrada en una instancia de grupo principal o de lectura existente, 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
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: Es el ID del clúster. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
• INSTANCE_ID: el ID de la instancia

Método HTTP y URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Cuerpo JSON de la solicitud:

{
  "connectionPoolConfig": {
    "enabled": true
  }
}

Conéctate a la agrupación de conexiones administrada

La conexión a la agrupación de conexiones administrada es idéntica a las conexiones directas a la base de datos, excepto por un puerto diferente. La agrupación de conexiones administrada escucha en el puerto 6432. Cualquier usuario que se agregue a la instancia de AlloyDB puede conectarse con la agrupación de conexiones administrada.

Conéctate con la autenticación integrada

En el ejemplo de comando, se conecta tu instancia de AlloyDB a la agrupación de conexiones administrada con la autenticación integrada.

psql postgresql://USERNAME:PASSWORD@IP_ADDRESS:6432/postgres

Reemplaza lo siguiente:

• USERNAME: el nombre de usuario de la base de datos para conectarse a la instancia de AlloyDB.
• PASSWORD: la contraseña del usuario
• IP_ADDRESS: Es la dirección IP de la instancia de AlloyDB.

Nota: No se admiten las conexiones de usuarios con el rol REPLICATION.

Conéctate con conexiones SSL

El modo SSL de la instancia también se aplica a cualquier conexión al grupo de conexiones administrado. De forma predeterminada, solo se aceptan conexiones SSL. Para permitir conexiones sin encriptar, usa el siguiente comando de gcloud alloydb instances update para establecer el modo SSL de la instancia en ALLOW_UNENCRYPTED_AND_ENCRYPTED.

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED

Conéctate con la autenticación de IAM

Puedes conectarte a la agrupación de conexiones administrada con la autenticación de IAM de una de las siguientes dos maneras:

• Autentica con un token de OAuth 2.0: Usa gcloud CLI para obtener un token de OAuth 2.0 y úsalo como contraseña cuando te conectes al puerto 6432. Para obtener más información, consulta Autentica con un token de OAuth 2.0.

• Autenticar automáticamente: Usa el proxy de autenticación de AlloyDB con la marca --auto-iam-authn o habilita la autenticación de IAM de manera programática con los conectores de lenguajes para AlloyDB.

Visualiza estadísticas sobre los grupos de conexiones administradas

Cuando habilitas la agrupación de conexiones administrada en tu instancia de AlloyDB, puedes conectarte a la consola de estadísticas integrada para ver información detallada y en tiempo real sobre tus grupos de conexiones. Puedes acceder a la consola de estadísticas en el puerto 6432 a través de una dirección IP privada con el acceso privado a servicios o Private Service Connect. La consola de estadísticas es útil para supervisar las conexiones activas o inactivas, solucionar problemas de tiempos de espera y optimizar los tamaños de los grupos.

Para usar la consola de estadísticas, sigue estos pasos:

1. De forma predeterminada, ningún usuario de la base de datos tiene autorización para acceder a la consola de estadísticas. Debes usar Google Cloud CLI para especificar qué usuarios de la base de datos pueden conectarse, lo que los incluye en la lista de entidades permitidas para acceder a la consola de estadísticas.

   Para agregar un usuario de la consola de estadísticas, usa el comando gcloud alloydb instances update:

   gcloud alloydb instances update INSTANCE_ID \
   --project=PROJECT_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --connection-pooling-stats-users=STATS_USERS
   

   Reemplaza lo siguiente:

   • INSTANCE_ID: Es el nombre de la instancia de AlloyDB para la que deseas autorizar a los usuarios de la consola de estadísticas.
   • STATS_USERS: Es una lista separada por comas de nombres de usuario de la base de datos.
   • PROJECT_ID: el ID del proyecto
   • REGION_ID: Es el ID de la región.
   • CLUSTER_ID: Es el ID del clúster.

2. Conéctate a la instancia en el puerto 6432. Cada instancia individual del agrupador de conexiones mantiene sus propias métricas en una base de datos con un número único. Especifica la base de datos de estadísticas pertinente para el agrupador que deseas supervisar:

   • Para los agrupadores estándar, usa alloydb_mcp_stats_POOLER_ID. El ID es 1, hasta la cantidad de agrupadores que se ejecutan en la instancia.
   • Para el agrupador de Auth Proxy, usa alloydb_mcp_stats_authproxy_pooler1.
   Nota: Solo se puede acceder a la base de datos de la consola de estadísticas del agrupador del proxy de autenticación conectándose con el cliente del proxy de autenticación.

   psql postgresql://USERNAME:PASSWORD@IP_ADDRESS:6432/alloydb_mcp_stats_1
   

   Reemplaza lo siguiente:

   • POOLER_ID: Es el ID del agrupador de conexiones. El ID es 1, hasta la cantidad de agrupadores que se ejecutan en la instancia.
   • USERNAME: Es el nombre de usuario de la base de datos para conectarse a la instancia de AlloyDB.
   • PASSWORD: la contraseña del usuario
   • IP_ADDRESS: Es la dirección IP de la instancia de AlloyDB. Debe ser una dirección de Private Service Connect (PSC) o de acceso privado a servicios (PSA).

3. Después de conectarte, ejecuta comandos de SHOW compatibles con PgBouncer para ver las métricas, por ejemplo:

   • SHOW STATS;: Muestra estadísticas generales de cada base de datos.
   • SHOW POOLS;: Muestra el estado de todos los grupos de conexiones actuales.
   • SHOW CLIENTS;: Muestra información sobre las conexiones de clientes actuales.

Para obtener una lista completa de los comandos disponibles, consulta la documentación oficial de PgBouncer.

Modifica la agrupación de conexiones administrada para una instancia

Después de habilitar la agrupación de conexiones administrada, puedes personalizar las opciones de agrupación de conexiones administrada para satisfacer las necesidades de tu instancia con las opciones de configuración avanzada. Estas opciones de configuración se denominan marcas de agrupación de conexiones administradas. Para obtener más información, consulta Opciones de configuración avanzada. Estas opciones también se aplican al agrupador del proxy de autenticación de AlloyDB.

Puedes modificar las opciones de configuración de la agrupación de conexiones administrada para una instancia existente con la consola de Google Cloud , Google Cloud CLI o la API de AlloyDB.

Console

1. Ve a la página Clústeres.

   Ir a los clústeres

2. Haz clic en un clúster en la columna Nombre del recurso.

3. En la página Descripción general, navega a Instancias en tu clúster.

4. Haz clic en Editar instancia o Editar grupo de lectura para la instancia que deseas modificar.

5. En Grupo de conexiones administrado, expande Opciones avanzadas de agrupación.

6. Modifica las opciones avanzadas de agrupación que quieras actualizar. Puedes modificar las siguientes opciones:

   • Modo de conexión
   • Tamaño máximo del grupo
   • Tamaño mínimo del grupo
   • Cantidad máxima de conexiones de cliente
   • Tiempo de espera de la conexión de cliente inactiva(s)
   • Tiempo de espera de la conexión del servidor inactivo(s)
   • Tiempo de espera de la consulta(s)
   • Cantidad máxima de instrucciones preparadas
   • Ignorar parámetros de inicio
   • Duración del servidor(s)

7. Haz clic en Actualizar instancia.

gcloud

Para modificar las opciones de configuración de la agrupación de conexiones administradas de una instancia existente, usa el siguiente comando gcloud alloydb instances update:

  gcloud alloydb instances update INSTANCE_ID \
    --project=PROJECT_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    { \
      --connection-pooling-pool-mode=CONNECTION_MODE \
      | --connection-pooling-max-pool-size=MAX_POOL_SIZE \
      | --connection-pooling-min-pool-size=MIN_POOL_SIZE \
      | --connection-pooling-max-client-connections=MAX_CLIENT_CONNECTIONS \
      | --connection-pooling-server-idle-timeout=SERVER_IDLE_TIMEOUT_PERIOD \
      | --connection-pooling-query-wait-timeout=QUERY_WAIT_TIMEOUT_PERIOD \
      | --connection-pooling-ignore-startup-parameters=IGNORE_STARTUP_PARAMETERS \
      | --connection-pooling-max-prepared-statements=MAX_PREPARED_STATEMENTS \
      | --connection-pooling-server-lifetime=SERVER_LIFETIME \
      | --connection-pooling-client-connection-idle-timeout=CLIENT_CONNECTION_IDLE_TIMEOUT \
    }

Reemplaza lo siguiente:

• INSTANCE_ID: Es el nombre de la instancia de AlloyDB para la que deseas modificar las opciones de grupos de conexiones administrados.
• PROJECT_ID: el ID del proyecto
• REGION_ID: Es el ID de la región.
• CLUSTER_ID: Es el ID del clúster.

• Puedes configurar las siguientes opciones:

  • --connection-pooling-pool-mode: Debe ser session o transaction.
  • --connection-pooling-max-pool-size
  • --connection-pooling-min-pool-size
  • --connection-pooling-max-client-connections
  • --connection-pooling-server-idle-timeout
  • --connection-pooling-query-wait-timeout
  • --connection-pooling-ignore-startup-parameters
  • --connection-pooling-max-prepared-statements
  • --connection-pooling-server-lifetime
  • --connection-pooling-client-connection-idle-timeout

REST

Para modificar las opciones de configuración de la agrupación de conexiones administradas de una instancia existente, 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
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: Es el ID del clúster. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
• INSTANCE_ID: el ID de la instancia

• Puedes configurar las siguientes opciones:

  • POOL_MODE. Debe ser session o transaction.
  • MAX_POOL_SIZE
  • MIN_POOL_SIZE
  • MAX_CLIENT_CONNECTIONS
  • SERVER_IDLE_TIMEOUT
  • QUERY_WAIT_TIMEOUT
  • IGNORE_STARTUP_PARAMETERS
  • MAX_PREPARED_STATEMENTS
  • SERVER_LIFETIME
  • CLIENT_CONNECTION_IDLE_TIMEOUT
  • STATS_USERS

Método HTTP y URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Cuerpo JSON de la solicitud:

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connections": "MAX_CLIENT_CONNECTIONS",
      "server_connection_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS",
      "max_prepared_statements": "MAX_PREPARED_STATEMENTS",
      "server_lifetime": "SERVER_LIFETIME",
      "client_connection_idle_timeout": "CLIENT_CONNECTION_IDLE_TIMEOUT",
      "stats_users": "STATS_USERS"
    }
  }
}

Visualiza el estado de la agrupación de conexiones administrada de una instancia

Puedes ver el estado de la agrupación de conexiones administrada de una instancia con la consola de Google Cloud , Google Cloud CLI o la API de AlloyDB.

Console

1. Ve a la página Clústeres.

   Ir a los clústeres

2. Haz clic en un clúster en la columna Nombre del recurso.

3. En la página Descripción general, busca la instancia para la que deseas ver el estado de la agrupación de conexiones administrada. En el campo Grupo de conexiones administrado, se muestra si está habilitado o inhabilitado.

gcloud

Para ver el estado de la agrupación de conexiones administrada de una instancia existente, usa el siguiente comando gcloud alloydb instances describe:

gcloud alloydb instances describe INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --format="value(connectionPoolConfig.enabled)"

Reemplaza lo siguiente:

• INSTANCE_ID: Es el nombre de la instancia de AlloyDB para la que deseas ver el estado de la agrupación de conexiones administrada.
• PROJECT_ID: el ID del proyecto
• REGION_ID: Es el ID de la región.
• CLUSTER_ID: Es el ID del clúster.

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

True

REST

Para ver el estado de la agrupación de conexiones administrada de tu instancia de AlloyDB, usa el siguiente comando y busca connectionPoolConfig:

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

• PROJECT_ID: el ID del proyecto
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: Es el ID del clúster. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
• INSTANCE_ID: el ID de la instancia

Método HTTP y URL:

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Inhabilita la agrupación de conexiones administradas para una instancia existente

Puedes inhabilitar la agrupación de conexiones administrada para una instancia existente con la consola deGoogle Cloud , Google Cloud CLI o la API de AlloyDB.

Console

1. Ve a la página Clústeres.

   Ir a los clústeres

2. Haz clic en un clúster en la columna Nombre del recurso.

3. En la página Descripción general, navega a Instancias en tu clúster.

4. Haz clic en Editar instancia o Editar grupo de lectura en la instancia en la que deseas inhabilitar la reducción de conexiones administradas.

5. En Grupo de conexiones administrado, desmarca la casilla de verificación Habilitar el grupo de conexiones administrado.

6. Haz clic en Actualizar instancia.

   Nota: Después de inhabilitar la agrupación de conexiones administrada, se descartan todas las conexiones que se realizaron a la agrupación de conexiones administrada.

gcloud

Para inhabilitar la agrupación de conexiones administrada en una instancia existente, usa el siguiente comando gcloud alloydb instances update:

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --no-enable-connection-pooling

Reemplaza lo siguiente:

• INSTANCE_ID: Es el nombre de la instancia de AlloyDB para la que deseas inhabilitar la agrupación de conexiones administrada.
• PROJECT_ID: el ID del proyecto
• REGION_ID: Es el ID de la región.
• CLUSTER_ID: Es el ID del clúster.

REST

Para inhabilitar la agrupación de conexiones administrada en una instancia existente, usa el siguiente comando y establece connectionPoolConfig.enabled en false:

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

• PROJECT_ID: el ID del proyecto
• LOCATION_ID: Es el ID de la región del clúster.
• CLUSTER_ID: Es el ID del clúster. Debe comenzar con una letra minúscula y puede contener letras minúsculas, números y guiones.
• INSTANCE_ID: el ID de la instancia

Método HTTP y URL:

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Cuerpo JSON de la solicitud:

{
  "connectionPoolConfig": {
    "enabled": false
  }
}

Supervisa la agrupación de conexiones administrada

AlloyDB proporciona las siguientes métricas para ayudarte a supervisar cómo se ejecuta la agrupación de conexiones administrada en tu instancia. Cada métrica se etiqueta con el ID del agrupador. Puedes ver estas métricas con el Explorador de métricas.

Nombre de la métrica	Descripción
Cantidad de grupos de conexiones /database/conn_pool/num_pools	Es la cantidad total de grupos de conexiones por base de datos.
Conexiones de clientes /database/conn_pool/client_connections	Realiza un seguimiento de la cantidad de conexiones de clientes agrupadas por el estado de la conexión de cliente por base de datos. 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 consulta pendientes. waiting: Es la cantidad de clientes que esperan una conexión de servidor por base de datos.
Conexiones del servidor /database/conn_pool/server_connections	Realiza un seguimiento de la cantidad de conexiones de servidor agrupadas por el estado de la conexión de servidor por base de datos. Los estados incluidos en esta métrica son los siguientes: active: Es la cantidad de conexiones activas por base de datos. idle: Es la cantidad de conexiones de servidor inactivas por base de datos.
Tiempo de espera promedio /database/conn_pool/client_connections_avg_wait_time	Es el tiempo promedio que pasan todos los clientes en estado de espera para un servidor en microsegundos por base de datos.

Para obtener más información, consulta Métricas de AlloyDB.

Limitaciones

Se aplica la siguiente limitación:

• Si usas la agrupación de conexiones administrada en el modo de agrupación de transacciones, no se admiten las siguientes funciones de SQL:
  • SET/RESET
  • LISTEN
  • WITH HOLD CURSOR
  • PREPARE/DEALLOCATE
  • PRESERVE/DELETE ROW tablas temporales
  • LOAD
  • Bloqueos de asesoramiento a nivel de sesión
  • Planes preparados a nivel del protocolo
• La agrupación de conexiones administrada no es compatible con las conexiones IP públicas.
• No se admiten las conexiones de usuarios con el rol REPLICATION de PostgreSQL.