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

En esta página, se describe qué es el grupo de conexiones administrado y cómo usarlo con tus instancias de Cloud SQL.

El grupo de conexiones administrado te permite escalar tus cargas de trabajo mediante la optimización del uso de recursos y la latencia de conexión de tus instancias de Cloud SQL para PostgreSQL con el grupo. El grupo de conexiones administrado asigna conexiones de servidor a las solicitudes entrantes de forma dinámica cuando es posible. Esto proporciona mejoras significativas en el rendimiento, en especial para las conexiones ajustadas, ya que absorbe los aumentos repentinos de conexiones y reutiliza las conexiones de bases de datos existentes. En lugar de conectarse a una base de datos en particular, el grupo de conexiones administrado se conecta a un clúster de grupos de conexiones, que proporcionan tiempos de conexión más cortos y escalabilidad para tus cargas de trabajo. La cantidad de grupos de recursos que se usan se basa en la cantidad de núcleos de vCPU de tu instancia.

Si bien puedes usar la agrupación de conexiones administrada para cualquier carga de trabajo de transacción, esta proporciona la mayor cantidad de rendimiento y latencia con aplicaciones que contienen conexiones de corta duración o 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 reducción de conexiones administrada puede ser ligeramente menor que cuando se usa una conexión directa. En este caso, la agrupación de conexiones administrada proporciona escalamiento de conexiones cuando la cantidad de conexiones es muy alta. Sin embargo, para las aplicaciones que suelen establecer conexiones de larga duración, puedes usar conexiones directas a tu instancia.

Para obtener más información sobre cómo habilitar el grupo de conexiones administrado, consulta Configura el grupo de conexiones administrado.

Requisitos

Para usar el grupo de conexiones administrado, tu instancia debe cumplir con los siguientes requisitos:

  • Tu instancia debe ser de la edición de Cloud SQL Enterprise Plus.
  • Debes conectarte a tu instancia con una conexión directa o solo con el proxy de autenticación de Cloud SQL.
  • Debes conectarte a tu instancia con un nombre de usuario y una contraseña válidos. Los usuarios de IAM y de grupos de IAM no son compatibles cuando se usa el grupo de conexiones administrado.
  • Tu instancia debe estar configurada para el acceso a servicios privados, usar una IP pública o ser una instancia nueva con Private Service Connect habilitado.
  • Tu instancia debe usar la nueva arquitectura de red de Cloud SQL.
  • El grupo de conexiones administrado requiere un número de versión de mantenimiento mínimo de POSTGRES_$version.R20250302.00_04. Para obtener más información, consulta Mantenimiento de autoservicio.

Opciones de configuración disponibles

La agrupación de conexiones administrada ofrece las siguientes opciones de agrupación que puedes configurar con el parámetro pool_mode:

  • transaction (predeterminado): agrupa las conexiones a nivel de la transacción.
  • session: Agrupa las conexiones a nivel de la sesión.

También puedes personalizar el grupo de conexiones administrado mediante los siguientes parámetros de configuración:

  • max_pool_size: Es el tamaño máximo del grupo de conexiones. El valor predeterminado es de 50 conexiones.
  • min_pool_size: El tamaño del umbral del grupo de conexiones. Si la cantidad de conexiones de servidor es inferior a min_pool_size, agrega más conexiones de servidor al grupo. El valor predeterminado es 0 conexiones.
  • max_client_connections: Es la cantidad máxima de conexiones permitidas para tu instancia. El valor predeterminado es 5,000 conexiones.
  • 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 de 600 segundos.
  • query_wait_timeout: Es el tiempo que una consulta espera hasta que se agota el tiempo de espera. Este valor puede variar de 0 a 2,147,483 segundos, y el valor predeterminado es de 120 segundos.
  • max_prepared_statements: Es la cantidad máxima de comandos de sentencias preparadas nominadas a nivel de protocolo compatibles con el modo de agrupación de transacciones. El valor predeterminado es 0.
  • ignore_startup_parameters: Son los parámetros que deseas ignorar y de los que no se realiza un seguimiento en los paquetes de inicio del grupo de conexiones administrado 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. El valor predeterminado es 3,600 segundos.

Limitaciones

Ten en cuenta las siguientes limitaciones cuando uses el grupo de conexiones administrado con tus instancias de la edición de Cloud SQL Enterprise Plus:

  • Si habilitas el grupo de conexiones administrado en una instancia existente, se reiniciará la base de datos.
  • Cuando usas la API de Cloud SQL para habilitar, inhabilitar o configurar el aprovisionamiento de conexiones administrado, la API de instance.update no puede contener ninguna otra actualización de configuración de la instancia.
  • El grupo de conexiones administrado 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 Go de Cloud SQL, te recomendamos una versión mínima de Go de 1.24. Si usas Go versión 1.23 o anterior, es posible que experimentes limitaciones de rendimiento cuando uses el grupo de conexiones administrado.

  • Si usas el grupo de conexiones administrado en el modo de grupo transaction, entonces las siguientes funciones de SQL no son compatibles:

    • SET/RESET
    • LISTEN
    • WITH HOLD CURSOR
    • PREPARE/DEALLOCATE
    • Tablas temporales de PRESERVE/DELETE ROW
    • LOAD
    • Bloqueos de advertencia a nivel de la sesión

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

¿Qué sigue?