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

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

El grupo de conexiones administrado (MCP) 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 MCP 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 MCP se conecta a un clúster de grupos de recursos, que proporcionan 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 vCPU de tu instancia.

Si bien puedes usar MCP para cualquier carga de trabajo transaccional, MCP proporciona el mayor beneficio de rendimiento y latencia con aplicaciones que contienen conexiones de corta duración o aplicaciones que generan un aumento repentino de la conexión.

En el caso de las conexiones de larga duración, el rendimiento de la conexión con MCP puede ser ligeramente inferior al de una conexión directa. En este caso, el MCP 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 MCP, consulta Configura el grupo de conexiones administrado.

Requisitos

Para usar MCP, 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 MCP.
  • 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 MCP 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

MCP 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 MCP 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 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 de MCP de forma predeterminada.
  • SERVER_LIFETIME: Es el tiempo máximo que no se usa una conexión de servidor antes de que la cierre MCP. El valor predeterminado es 3,600 segundos.

Limitaciones

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

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

  • Si usas MCP en el modo de agrupación TRANSACTION, entonces no se admiten las siguientes funciones de SQL:

    • 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?