Configura la agrupación de conexiones administradas

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se describe cómo habilitar, conectarse a y supervisar el grupo de conexiones administrado en AlloyDB para PostgreSQL. La agrupación de conexiones administrada es un patrón de diseño que optimiza la administración de conexiones de bases de datos manteniendo un grupo de conexiones preestablecidas. Luego, la aplicación reutiliza este grupo de conexiones en lugar de abrir y cerrar conexiones para cada operación de la base de datos, lo que mejora el rendimiento y el uso de recursos.

Con la agrupación de conexiones administrada, puedes escalar las cargas de trabajo de la base de datos mediante la optimización del uso de recursos y la latencia de conexión de tus instancias de AlloyDB. La agrupación de conexiones administrada asigna conexiones del servidor a las solicitudes entrantes de forma dinámica cuando es posible mediante la agrupación y la multiplexación. Este enfoque proporciona mejoras de rendimiento, en especial para las conexiones ajustadas, ya que absorbe los aumentos repentinos de la conexión y reutiliza las conexiones de bases de datos existentes. En lugar de conectarse a una base de datos específica, cuando se usa la agrupación de conexiones administrada, una aplicación se conecta a un grupo de conexiones, lo que proporciona tiempos de conexión más cortos y escalabilidad para tus cargas de trabajo de lectura.

Si bien puedes usar el grupo de conexiones administrado para cualquier carga de trabajo transaccional, este es más adecuado para aplicaciones que contienen más conexiones de corta duración o aplicaciones que podrían experimentar un aumento de conexiones.

Antes de comenzar

Debes conectarte a tu instancia mediante una conexión directa. La agrupación de conexiones administrada no admite la conexión con el proxy de autenticación de AlloyDB ni los conectores de lenguaje de AlloyDB.

Roles obligatorios

Para obtener el permiso que necesitas para habilitar y usar el grupo de conexiones administrado, pídele a tu administrador que te otorgue el rol de IAM Administrador de Cloud 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 el grupo de conexiones administrado.

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

Opciones de configuración avanzada

El grupo de conexiones administrado de AlloyDB admite las siguientes opciones de configuración de agrupación avanzadas. Puedes personalizar el grupo de conexiones administrado para satisfacer las necesidades de tu instancia con estas opciones de configuración. Puedes establecer estas configuraciones a nivel de la instancia con la console de Google Cloud, gcloud CLI o la API de AlloyDB.

De forma predeterminada, el grupo de conexiones administrado inicia conexiones con el servidor de AlloyDB. Cuando se establece y autentica una conexión 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 permanecen inactivas durante más tiempo que el período de tiempo de espera de la conexión del servidor inactiva.

Habilita la agrupación de conexiones administradas

Puedes habilitar el grupo de conexiones administrado para cualquier instancia nueva o existente.

Habilita la PITR para una instancia principal nueva

Para crear una instancia principal nueva con el grupo de conexiones administrado habilitado, consulta Cómo crear una instancia principal. Puedes habilitar el grupo de conexiones administrado para una instancia con la consola de Google Cloud, Google Cloud CLI o la API de AlloyDB.

Habilita la función para una instancia de grupo de lectura nueva

Para crear una instancia de grupo de lectura nueva con el grupo de conexiones administrado habilitado, consulta Cómo crear una instancia de grupo de lectura. Puedes habilitar el grupo de conexiones administrado para una instancia con la consola de Google Cloud, Google Cloud CLI o la API de AlloyDB.

Habilita la función para una instancia existente

Puedes habilitar el grupo de conexiones administrado para una instancia existente con la consola de Google Cloud, Google Cloud CLI o la API de AlloyDB.

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

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

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

Cómo conectarse al grupo de conexiones administrado

La conexión al grupo de conexiones administrado es idéntica a las conexiones directas a la base de datos, excepto que se realiza en 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 el grupo de conexiones administrado.

Cómo conectarse con la autenticación integrada

El ejemplo de comando conecta tu instancia de AlloyDB al grupo de conexiones administrado con autenticación integrada.

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

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 las conexiones SSL. Para permitir conexiones no encriptadas, usa el siguiente comando 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

Modifica la agrupación de conexiones administradas de una instancia

Después de habilitar el grupo de conexiones administrado, puedes personalizar las opciones de grupo de conexiones administrado para satisfacer las necesidades de tu instancia con las opciones de configuración avanzadas. Estas opciones de configuración se denominan marcas de aprovisionamiento de conexiones administradas. Para obtener más información sobre las opciones de configuración, sus valores predeterminados y los rangos, consulta Opciones de configuración avanzadas.

Puedes modificar las opciones de configuración del grupo de conexiones administrado de una instancia existente con la consola de Google Cloud, Google Cloud CLI o la API de AlloyDB.

  gcloud alpha 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_CONNECTION \
      | --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 \
    }

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

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connection": "MAX_CLIENT_CONNECTION",
      "server_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS"
    },
  }
}

Consulta el estado del grupo de conexiones administrado de una instancia

Puedes ver el estado del grupo de conexiones administrado de una instancia con la consola de Google Cloud, Google Cloud CLI o la API de AlloyDB.

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

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 el grupo de conexiones administrado para una instancia existente con la consola de Google Cloud, Google Cloud CLI o la API de AlloyDB.

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

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

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

Supervisa la agrupación de conexiones administradas

AlloyDB proporciona las siguientes métricas para ayudarte a supervisar cómo se ejecuta el agrupamiento de conexiones administrado en tu instancia. Puedes ver estas métricas con el Explorador de métricas.

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

Limitaciones

Se aplican las siguientes limitaciones durante la versión Versión preliminar y están sujetas a cambios o eliminaciones en la versión GA o después:

• La agrupación de conexiones administrada no admite la conexión con el proxy de autenticación de AlloyDB ni los conectores de lenguaje de AlloyDB.
• Si usas el grupo de conexiones administrado en el modo de grupo de transacciones, 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
  • Planes preparados a nivel del protocolo