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 optimizando la utilización de recursos y la latencia de conexión para tus instancias de Cloud SQL para PostgreSQL con el uso de grupos. La agrupación de conexiones administrada asigna dinámicamente conexiones de servidor a las solicitudes entrantes cuando es posible. Esto ofrece mejoras significativas en el rendimiento, en especial para las conexiones escaladas, ya que absorbe los picos repentinos de conexión y reutiliza las conexiones de bases de datos existentes. En lugar de conectarse a una base de datos en particular, la agrupación de conexiones administrada se conecta a un clúster de agrupadores, lo que proporciona tiempos de conexión más cortos y escalabilidad para tus cargas de trabajo. La cantidad de agrupadores que se usan se basa en la cantidad de núcleos de CPU virtuales de tu instancia.

Si bien puedes usar la agrupación de conexiones administrada para cualquier carga de trabajo transaccional, esta proporciona el mayor beneficio de rendimiento y latencia con las 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 administradas puede ser ligeramente inferior al que se obtiene con una conexión directa. En este caso, la agrupación de conexiones administrada proporciona un ajuste de escala de las 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 la reducción de conexión administrada, consulta Cómo configurar la reducción de conexión administrada.

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 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 con el uso del grupo de conexiones administrado.
  • Tu instancia debe estar configurada para el acceso privado a servicios, 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.
  • La agrupación de conexiones administrada 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.

Puertos que usa el grupo de conexiones administrado para instancias de Cloud SQL

Cuando habilitas el grupo de conexiones administrado, cambian los puertos que usan las instancias de Cloud SQL para entregar el tráfico de la base de datos. Los puertos que usa la agrupación de conexiones administrada son los siguientes:

  • Puerto TCP 5432: Se usa para las conexiones directas del servidor de bases de datos de PostgreSQL. Este es el número de puerto predeterminado que se usa cuando se establece una conexión directa con el cliente psql.
  • Puerto TCP 6432: Se usa para las conexiones directas del servidor de PgBouncer. Para conectarte con este puerto, especifica psql -p 6432 cuando te conectes directamente con el cliente psql.
  • Puerto TCP 3307: Se usa para las conexiones solo del proxy de autenticación de Cloud SQL por parte de un servidor de PgBouncer. Cuando usas el proxy de Cloud SQL Auth para conectarte a Pgbouncer, este número de puerto se configura con el cliente del proxy de Cloud SQL Auth y no se puede cambiar.

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 administradas con los siguientes parámetros de configuración:

  • max_pool_size: Es el tamaño máximo del grupo de conexiones. El valor predeterminado es 50 conexiones.
  • min_pool_size: Es el tamaño del umbral del grupo de conexiones. Si la cantidad de conexiones de servidor es menor que 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 del servidor permanece inactiva antes de que se agote el tiempo de espera. Este valor puede oscilar entre 0 y 2,147,483 segundos, y el valor predeterminado es de 600 segundos.
  • query_wait_timeout: Es el tiempo que espera una consulta hasta que se agota el tiempo de espera. Este valor puede oscilar entre 0 y 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 con nombre a nivel del protocolo que se admiten en el modo de agrupación de transacciones. El valor predeterminado es 0.
  • ignore_startup_parameters: Son los parámetros que deseas ignorar y que no se rastrean en los paquetes de inicio de la agrupación de conexiones administradas de forma predeterminada.
  • server_lifetime: Es el tiempo máximo que una conexión del servidor permanece sin usar antes de que el grupo de conexiones administradas 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:

  • Habilitar el grupo de conexiones administrado en una instancia existente provoca el reinicio de la base de datos.
  • Cuando usas la API de Cloud SQL para habilitar, inhabilitar o configurar el Agrupamiento de conexiones administradas, la API de instance.update no puede contener ninguna otra actualización de configuración de la instancia.
  • El agrupamiento de conexiones administrado solo se puede usar con la versión 2.15.2 y versiones posteriores del proxy de Cloud SQL Auth.
  • Si usas el conector de lenguaje de Go en Cloud SQL, te recomendamos que uses la versión 1.24 de Go como mínimo. Si usas la versión 1.23 de Go o una anterior, es posible que experimentes limitaciones en el rendimiento cuando uses el grupo de conexiones administrado.

  • Si usas el agrupamiento de conexiones administrado en el modo de agrupamiento 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 asesoramiento 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?