Descripción general de la agrupación de conexiones administrada

La agrupación de conexiones administrada te permite escalar tus cargas de trabajo optimizando el uso de recursos y la latencia de conexión para tus instancias de Cloud SQL. PostgreSQL crea un proceso nuevo para cada conexión, lo que genera un uso de memoria y una sobrecarga de configuración de la conexión. En arquitecturas que establecen con frecuencia muchas conexiones de corta duración, como microservicios o aplicaciones sin servidores que se ejecutan en Cloud Run, esta sobrecarga puede afectar el rendimiento y la escalabilidad de la base de datos.

Con la agrupación de conexiones administrada habilitada, los clientes se conectan a un clúster de grupo de conexiones intermediario en lugar de conectarse directamente al servidor de la base de datos. Esta asignación dinámica proporciona mejoras de rendimiento, en especial para las conexiones escaladas, ya que absorbe los aumentos repentinos de conexiones y reutiliza las conexiones de base de datos existentes.

Agrupadores de conexiones y grupos de conexiones

Cuando las aplicaciones cliente se conectan a una instancia con la agrupación de conexiones administrada habilitada, se conectan a un clúster de grupo de conexiones intermediario en lugar de conectarse directamente al servidor de la base de datos. El clúster de grupos de conexiones consta de uno o más agrupadores de conexiones. Un agrupador de conexiones es un servicio de proxy de base de datos que administra y enruta las conexiones de la base de datos entre las aplicaciones cliente y el servidor de la base de datos.

Un agrupador de conexiones mantiene los grupos de conexiones como un conjunto de conexiones abiertas y reutilizables del servidor de bases de datos por base de datos y par de usuarios.

Cuando una aplicación cliente autenticada se conecta a una base de datos como un usuario específico, el agrupador de conexiones enruta la solicitud al grupo de conexiones correspondiente:

  • Si hay una conexión de servidor inactiva disponible en el grupo, el agrupador de conexiones la asigna a la solicitud del cliente.
  • Si no hay una conexión de servidor inactiva disponible y no se alcanzó el límite del grupo (max_pool_size), el agrupador de conexiones crea una nueva conexión de servidor en el grupo.
  • Si todas las conexiones del servidor en el grupo están en uso y se alcanzó el límite del grupo, el cliente pasa a un estado de espera hasta que una conexión del servidor esté disponible.
  • Cuando finaliza la solicitud, la conexión del servidor vuelve al grupo de conexiones para su reutilización.

Relación entre los grupos y los usuarios que los comparten

Un solo agrupador de conexiones puede administrar varios grupos de conexiones de forma simultánea, con un grupo para cada par único de base de datos y usuario de base de datos que se conecta a través de ese agrupador.

Si tu instancia ejecuta varios agrupadores de conexiones, cada uno de ellos mantiene de forma independiente su propio conjunto de grupos de conexiones para los pares de bases de datos y usuarios que se enrutan a él.

Las capacidades de rendimiento y escalamiento de la agrupación de conexiones administrada operan en varios niveles:

  • Escalamiento del clúster de grupos de conexiones: La cantidad de agrupadores de conexiones en el clúster se escala automáticamente según la cantidad de núcleos de CPU virtuales aprovisionados para la instancia (se divide el recuento de CPU virtuales por 4, con un mínimo de 1 agrupador de conexiones). Esto garantiza que la agrupación de conexiones no se convierta en un cuello de botella. Las conexiones de cliente entrantes se distribuyen entre los agrupadores de conexiones disponibles. Por ejemplo:

    • Una instancia con 2 o 4 CPU virtuales ejecuta 1 agrupador de conexiones.
    • Una instancia con 8 vCPUs ejecuta 2 agrupadores de conexiones.
    • Una instancia con 16 vCPU ejecuta 4 agrupadores de conexiones.
    • Una instancia con 32 CPU virtuales ejecuta 8 agrupadores de conexiones.
    • Una instancia con 64 vCPU ejecuta 16 agrupadores de conexiones.
  • Escalamiento de grupos y agrupadores: Debido a que los agrupadores de conexiones funcionan de forma independiente, todas las opciones de configuración se aplican por agrupador de conexiones, en lugar de aplicarse de forma global en toda la instancia. Las conexiones del servidor se crean a pedido hasta un límite máximo definido por max_pool_size para cada grupo administrado en cada agrupador de conexiones. Por ejemplo, si max_pool_size se establece en 50 en una instancia que ejecuta 2 agrupadores de conexiones (8 CPUs virtuales), cada agrupador de conexiones puede abrir hasta 50 conexiones de servidor para una base de datos y un par de usuarios específicos, lo que permite un total de hasta 100 conexiones de servidor en la instancia para ese grupo. El tamaño preciso del grupo es fundamental para el rendimiento: establecer un valor demasiado bajo puede generar tiempos de espera de conexión más largos, mientras que establecerlo demasiado alto puede desperdiciar recursos del servidor de la base de datos.

  • Configuraciones de conexión de cliente: Los límites de conexión de cliente y el comportamiento de tiempo de espera también se configuran por agrupador de conexiones. Entre los parámetros clave, se incluyen los siguientes:

    • max_client_connections: Limita la cantidad máxima de conexiones de cliente permitidas por agrupador de conexiones (el valor predeterminado es 5,000 conexiones para cada agrupador de conexiones).
    • client_connection_idle_timeout: Controla la duración que una conexión de cliente puede permanecer inactiva antes de que se agote el tiempo de espera.
    • query_wait_timeout: Controla la duración que espera una consulta para una conexión de servidor disponible en el grupo antes de que se agote el tiempo de espera.

Casos de uso y consideraciones

Ten en cuenta lo siguiente cuando uses la agrupación de conexiones administrada:

  • Si bien puedes usar la agrupación de conexiones administrada para cualquier carga de trabajo transaccional, proporciona el mayor beneficio de capacidad de procesamiento y latencia a las aplicaciones que contienen conexiones de corta duración o a las aplicaciones que generan un aumento repentino de conexiones.
  • En el caso de las conexiones de larga duración, el rendimiento de la conexión con la agrupación de conexiones administrada puede ser un poco menor que cuando se usa una conexión directa. En este caso, la agrupación de conexiones administrada proporciona un escalamiento de conexiones cuando la cantidad de conexiones es muy alta. Sin embargo, en el caso de las aplicaciones que suelen establecer conexiones de larga duración, es posible que desees evitar el uso de la agrupación de conexiones.
  • Puedes usar Identity and Access Management para proteger las conexiones a tu instancia según el puerto que use la agrupación de conexiones administrada. Para obtener más información sobre cómo funciona IAM en Cloud SQL y sus limitaciones, consulta Autenticación de IAM.

Para obtener más información sobre cómo habilitar la reducción de conexiones administradas, consulta Configura la reducción de conexiones administradas.

Requisitos

Para usar la agrupación de conexiones administrada, tu instancia debe cumplir con los siguientes requisitos:

  • Tu instancia debe ser de la edición Cloud SQL Enterprise Plus.
  • Debes conectarte a tu instancia solo con una conexión directa o el proxy de autenticación de Cloud SQL.
  • La instancia debe estar configurada para el acceso privado a servicios, usar una IP pública o tener Private Service Connect habilitado.
  • Tu instancia debe usar la nueva arquitectura de red de Cloud SQL.
  • La agrupación de conexiones administrada requiere un número de versión de mantenimiento mínimo de POSTGRES_$version.R20250727.00_14. Para obtener más información sobre cómo realizar el mantenimiento de autoservicio, consulta Realiza el mantenimiento de autoservicio.

Opciones de agrupación

La agrupación de conexiones administrada te permite administrar cómo se agrupan las conexiones con el parámetro pool_mode. Puedes usar las siguientes opciones de reducción:

  • transaction (predeterminado): Agrupa las conexiones a nivel de transacción. Las conexiones se devuelven al grupo después de que se completa cada transacción. Cloud SQL recomienda usar el modo de agrupación transaction para las conexiones de corta duración.
  • session: Agrupa las conexiones a nivel de sesión. Cada sesión usa una conexión de servidor dedicada que mantiene un estado de sesión. Esto reduce la eficiencia de la agrupación. Cuando un cliente se desconecta, la conexión del servidor vuelve al grupo de conexiones.

Opciones de configuración avanzada

Puedes personalizar la agrupación de conexiones administrada con las siguientes opciones de configuración.

Nombre de la configuración Descripción
max_pool_size Es la cantidad máxima de conexiones de servidor permitidas para un par de base de datos y usuario en cada grupo de conexiones. Esta configuración se aplica por agrupador de conexiones. Determina este valor según los requisitos de tamaño de la instancia y del grupo.

El valor predeterminado es de 50 conexiones por base de datos y par de usuarios para cada agrupador de conexiones.
min_pool_size Es la cantidad mínima de conexiones de servidor disponibles en cualquier momento en cada grupo de conexiones. Esta configuración se aplica por agrupador de conexiones. Determina este valor según los requisitos de tamaño de la instancia y del grupo.

Si la cantidad de conexiones de servidor es menor que el min_pool_size, este parámetro de configuración agrega más conexiones de servidor al grupo. Esto ayuda a administrar los aumentos repentinos en la carga de la base de datos después de períodos de inactividad y garantiza que las conexiones estén disponibles y listas para usar.

El valor predeterminado es 0 conexiones.
max_client_connections Es la cantidad máxima de conexiones de cliente permitidas por agrupador de conexiones cuando se usa la agrupación de conexiones administrada. Determina este valor según los requisitos de tamaño de la instancia y del grupo.

El valor predeterminado es 5,000 conexiones para cada agrupador de conexiones.
max_prepared_statements Es la cantidad máxima de sentencias preparadas con nombre a nivel de protocolo admitidas por grupo de conexiones en el modo de agrupación transaction. Determina este valor según los requisitos de tamaño de la instancia y del grupo.

Si configuras esta opción como 0, se inhabilita la compatibilidad con las sentencias preparadas. Para obtener un rendimiento óptimo, este valor debe superar la cantidad de sentencias preparadas de uso frecuente en tu base de datos. Una gran cantidad de sentencias preparadas en la agrupación de conexiones administrada puede causar un aumento en el uso de memoria.

El valor predeterminado es 0 sentencias.
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.
server_connection_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.
query_wait_timeout Es el tiempo que una consulta espera una conexión de servidor en un grupo antes de que se agote el tiempo de espera.

Si estableces esta opción en 0, se inhabilita, lo que permite que los clientes hagan fila de forma indefinida. Habilitar esta opción evita que los servidores que no responden retengan las conexiones.

Este valor puede variar de 0 a 2,147,483 segundos, y el valor predeterminado es 120 segundos.
ignore_startup_parameters Son los parámetros que deseas ignorar y que no se registran en los paquetes de inicio de la agrupación de conexiones administrada de forma predeterminada.
server_lifetime Es el tiempo máximo que una conexión de servidor no se usa antes de que el grupo de conexiones administrado la cierre. Si el valor se establece en 0 segundos, la conexión se cierra de inmediato después de su uso.

El valor predeterminado es 3600 segundos.

Limitaciones

Cuando uses la agrupación de conexiones administrada con tus instancias de la edición Cloud SQL Enterprise Plus, ten en cuenta estas limitaciones:

  • Habilitar la agrupación de conexiones administrada en una instancia existente provoca el reinicio de la base de datos.
  • La agrupación de conexiones administrada solo se puede usar con la versión 2.15.2 y posteriores del proxy de autenticación de Cloud SQL.
  • Si usas el conector de lenguaje de Cloud SQL para Go, te recomendamos una versión mínima de Go de 1.24. Si usas la versión 1.23 o una anterior de Go, es posible que experimentes limitaciones en el rendimiento cuando uses el grupo de conexiones administrado.
  • Si usas la agrupación de conexiones administrada en el modo de agrupación transaction, no se admiten las siguientes funciones de SQL:

    • SET/RESET
    • LISTEN
    • WITH HOLD CURSOR
    • PREPARE/DEALLOCATE
    • PRESERVE/DELETE ROW tablas temporales
    • LOAD
    • Bloqueos de aviso a nivel de sesión
  • Si usas la biblioteca de interfaz de base de datos asyncpg para el agrupador de conexiones administradas en los puertos 3307 y 6432, debes actualizar el max_prepared_statements a un valor mayor que 0 para habilitar la compatibilidad con las declaraciones preparadas en el agrupador de conexiones administradas.

  • Si usas la versión 17 de Cloud SQL para PostgreSQL, no se admite la opción sslnegotiation=direct.

  • El seguimiento de IP de cliente no es compatible con la agrupación de conexiones administrada. Si habilitas almacenar las direcciones IP de clientes en Estadísticas de consultas, las direcciones IP de clientes se muestran como local en lugar de la dirección IP en sí.

Puertos que usa la agrupación de conexiones administrada

Cuando habilitas el agrupamiento de conexiones administrado, cambian los puertos que usan las instancias de Cloud SQL para entregar el tráfico de la base de datos. Puedes usar Identity and Access Management para proteger las conexiones, según el puerto.

Los puertos que usa la agrupación de conexiones administrada y sus opciones de IAM disponibles son los siguientes:

Conexiones del servidor que usa la agrupación de conexiones administrada

La configuración de la base de datos max_connections limita la cantidad máxima de conexiones de servidor que puede usar un agrupador en la agrupación de conexiones administrada. Cloud SQL recomienda ajustar este valor según los requisitos de carga de trabajo de tu instancia y el tamaño de la instancia de la base de datos. Durante la carga máxima, la cantidad de conexiones para la autenticación puede ser muy alta.

Si usas el valor predeterminado de max_pool_size de 50 conexiones por grupo, te recomendamos que reserves al menos 15 conexiones de servidor por CPU para el grupo de conexiones administrado cuando configures la marca max_connections para tu base de datos. Para obtener más información sobre la marca max_connections, consulta Cantidad máxima de conexiones simultáneas. Para modificar la marca max_connections de tu instancia, consulta Configura marcas de base de datos.

¿Qué sigue?