Configurer le pooling de connexions géré

Pour faire évoluer vos charges de travail AlloyDB pour PostgreSQL, absorber les pics de connexion soudains et réduire la latence de connexion, vous pouvez activer la mise en pool de connexions gérée. Le pooling de connexions géré maintient un pool de connexions serveur préétablies et multiplexe de manière dynamique les requêtes client entrantes sur ces connexions au lieu d'ouvrir et de fermer une connexion backend pour chaque opération de base de données.

Au lieu de se connecter directement au backend de la base de données, votre application se connecte à un pooler, ce qui réduit les temps de connexion et améliore l'évolutivité de vos charges de travail de lecture et d'écriture. Bien que vous puissiez utiliser le pooling de connexions géré pour n'importe quelle charge de travail transactionnelle, il est particulièrement adapté aux applications qui utilisent des connexions de courte durée ou qui subissent des pics de connexion.

Remarque : La mise en pool des connexions gérées est désactivée par défaut.

Avant de commencer

La mise en pool de connexions gérée est également compatible avec les connexions au proxy d'authentification AlloyDB ou aux connecteurs de langage AlloyDB.

Rôles requis

Pour obtenir l'autorisation nécessaire pour activer et utiliser le regroupement de connexions géré, demandez à votre administrateur de vous accorder le rôle IAM Administrateur AlloyDB (roles/alloydb.admin) sur l'instance AlloyDB. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation alloydb.instances.update, qui est nécessaire pour activer et utiliser la mise en pool de connexions gérée.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Options de configuration avancées

Le regroupement de connexions géré AlloyDB est compatible avec les options de configuration de regroupement avancées suivantes. Vous pouvez personnaliser le regroupement de connexions géré pour répondre aux besoins de votre instance en définissant ces configurations au niveau de l'instance à l'aide de la console Google Cloud , de gcloud CLI ou de l'API AlloyDB.

Nom de la configuration	Description
Mode de connexion (connection-pooling-pool-mode)	Pour le mode de connexion, vous pouvez sélectionner "transaction" (par défaut) ou "session". Transaction (transaction) : Regroupe les connexions au niveau d'une transaction. Une connexion au serveur est attribuée à un client lors d'une transaction. Une fois la transaction terminée, la connexion au serveur est remise dans le pool. Session (session) : Regroupe les connexions au niveau de la session. Une connexion au serveur est attribuée au client pendant toute la durée de sa connexion. Une fois que le client se déconnecte, la connexion au serveur est remise dans le pool.
Taille maximale du pool (connection-pooling-max-pool-size)	Taille maximale du pool de connexions par paire utilisateur/base de données. Cette valeur peut être comprise entre 1 et 262,042 connexions. La valeur par défaut est de 50 connexions.
Taille minimale du pool : (connection-pooling-min-pool-size)	Taille minimale du pool de connexions. Cette valeur peut être comprise entre 0 et 262,042 connexions. La valeur par défaut est 0 connexions.
Nombre maximal de connexions client (connection-pooling-max-client-connections)	Nombre maximal de connexions client simultanées autorisé. Cette valeur peut être comprise entre 1 et 262,042 connexions. La valeur par défaut est de 5000 connexions.
délai d'inactivité des connexions client(s) (connection-pooling-client-connection-idle-timeout)	Durée pendant laquelle une connexion client reste inactive avant d'expirer. Cette valeur peut être comprise entre 0 et 2,147,483 secondes. La valeur par défaut est de 0 secondes.
délai d'inactivité des connexions au serveur(s) (connection-pooling-server-idle-timeout)	Durée pendant laquelle une connexion au serveur reste inactive avant d'expirer. Cette valeur peut être comprise entre 0 et 2,147,483 secondes. La valeur par défaut est de 600 secondes.
Délai d'attente avant expiration des requêtes(s) (connection-pooling-query-wait-timeout)	Délai d'attente d'une requête avant son expiration. Cette valeur peut être comprise entre 0 et 2,147,483 secondes. La valeur par défaut est de 120 secondes.
Nombre maximal d'instructions préparées (connection-pooling-max-prepared-statements)	Nombre maximal de commandes d'instructions préparées envoyées en mode de mise en pool des transactions. Cette valeur peut être comprise entre 0 et 262,042. La valeur par défaut est 0.
Ignorer les paramètres de démarrage (connection-pooling-ignore-startup-parameters)	Liste d'éléments séparés par une virgule de paramètres de démarrage que le pooler ignore lorsqu'ils ne sont pas suivis par défaut dans les paquets de démarrage. La valeur par défaut est extra_float_digits.
Durée de vie des serveurs(s) (connection-pooling-server-lifetime)	Durée maximale pendant laquelle une connexion au serveur reste inutilisée avant que le regroupement de connexions géré ne la ferme. Cette valeur peut être comprise entre 0 et 2,147,483 secondes. La valeur par défaut est de 3600 secondes.
Utilisateurs des statistiques (connection-pooling-stats-users)	Liste d'utilisateurs de base de données séparés par une virgule autorisés à se connecter à la console de statistiques. Ce paramètre peut être configuré à l'aide de la Google Cloud CLI ou de l'API AlloyDB. Les utilisateurs autorisés peuvent accéder aux métriques avancées, qui sont conservées dans la base de données alloydb_mcp_stats_{pooler_id} pour chaque pooler.

Par défaut, le regroupement de connexions géré lance des connexions au serveur AlloyDB. Lorsqu'une connexion client est établie et authentifiée, la mise en pool des connexions gérées peut créer une ou plusieurs connexions serveur afin que la taille du pool corresponde à la configuration choisie. La connexion client se voit ensuite attribuer une connexion serveur disponible. Les connexions au serveur sont maintenues jusqu'à ce qu'elles soient explicitement fermées ou qu'elles soient inactives pendant une durée supérieure au délai d'inactivité des connexions au serveur.

Lorsque vous activez le regroupement de connexions géré, les connexions du serveur proxy d'authentification AlloyDB sont également regroupées à l'aide d'un pool distinct qui n'inclut que les connexions regroupées pour lesquelles le proxy d'authentification AlloyDB est activé.

Activez le pooling de connexions géré

Remarque : Pour activer le regroupement de connexions géré sur les instances AlloyDB créées avant novembre 2024, vous devez mettre à jour les paramètres réseau une seule fois. Cette mise à jour entraîne une brève interruption de la connectivité du réseau VPC, qui dure généralement moins de 15 secondes. L'adresse IP publique n'est pas affectée. Votre base de données ne redémarrera pas pendant ce processus.

Vous pouvez activer le pooling de connexions géré pour toutes les instances existantes ou nouvelles.

Activer pour une nouvelle instance principale

Pour créer une instance principale avec le pooling de connexions géré activé, consultez Créer une instance principale. Vous pouvez activer le regroupement de connexions géré pour une instance à l'aide de la consoleGoogle Cloud , de Google Cloud CLI ou de l'API AlloyDB.

Activer pour une nouvelle instance de pool de lecture

Pour créer une instance de pool de lecture avec le pooling de connexions géré activé, consultez Créer une instance de pool de lecture. Vous pouvez activer la mise en pool des connexions gérées pour une instance à l'aide de la consoleGoogle Cloud , de Google Cloud CLI ou de l'API AlloyDB.

Activer pour une instance existante

Vous pouvez activer la mise en pool des connexions gérées pour une instance existante à l'aide de la consoleGoogle Cloud , de Google Cloud CLI ou de l'API AlloyDB.

Console

1. Accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur un cluster dans la colonne Nom de la ressource.

3. Sur la page Présentation, accédez à Instances dans votre cluster.

4. Cliquez sur Modifier l'instance principale ou Modifier le pool de lecture.

5. Sous Pool de connexions géré, cochez la case Activer le pool de connexions géré.

6. Facultatif : pour configurer les options de pooling de connexions gérées, cliquez sur Options de pooling avancées.

   Vous pouvez personnaliser les options de mise en pool des connexions gérées pour répondre aux besoins de votre instance. Pour en savoir plus, consultez Options de configuration avancées.

7. Cliquez sur Enregistrer les modifications.

gcloud

Pour activer la mise en pool de connexions gérée pour une instance de pool principale ou de lecture existante, utilisez la commande gcloud alloydb instances update suivante :

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

Remplacez les éléments suivants :

• INSTANCE_ID : ID de l'instance AlloyDB pour laquelle vous souhaitez activer le regroupement de connexions géré.
• PROJECT_ID : ID du projet
• REGION_ID : ID de la région.
• CLUSTER_ID : ID du cluster.

Après avoir activé le pooling de connexions géré, vous pouvez personnaliser les options de pooling de connexions géré pour répondre aux besoins de votre instance en définissant les options de configuration avancées. Pour en savoir plus sur la définition des options de configuration, consultez Modifier la mise en pool des connexions gérées pour une instance.

REST

Pour activer la mise en pool de connexions gérée pour une instance principale ou un pool de lecture existants, utilisez la commande suivante et définissez connectionPoolConfig :

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID du projet
• LOCATION_ID : ID de la région du cluster.
• CLUSTER_ID : ID du cluster. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.
• INSTANCE_ID : ID de l'instance

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Se connecter au regroupement de connexions géré

La connexion au regroupement de connexions géré est identique aux connexions directes à la base de données, sauf qu'elle s'effectue sur un port différent. Le regroupement de connexions géré écoute sur le port 6432. Tout utilisateur ajouté à l'instance AlloyDB peut se connecter à l'aide du regroupement de connexions géré.

Se connecter à l'aide de l'authentification intégrée

L'exemple de commande connecte votre instance AlloyDB à la mise en pool de connexions gérée à l'aide de l'authentification intégrée.

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

Remplacez les éléments suivants :

• USERNAME : nom d'utilisateur de la base de données à connecter à l'instance AlloyDB.
• PASSWORD : mot de passe de l'utilisateur.
• IP_ADDRESS : adresse IP de l'instance AlloyDB.

Remarque : Les connexions des utilisateurs disposant du rôle REPLICATION ne sont pas acceptées.

Se connecter à l'aide de connexions SSL

Le mode SSL de l'instance s'applique également à toutes les connexions au pool de connexions géré. Par défaut, seules les connexions SSL sont acceptées. Pour autoriser les connexions non chiffrées, utilisez la commande gcloud alloydb instances update suivante pour définir le mode SSL de l'instance sur 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

Se connecter à l'aide de l'authentification IAM

Vous pouvez vous connecter au pooling de connexions géré à l'aide de l'authentification IAM de deux manières :

• S'authentifier avec un jeton OAuth 2.0 : utilisez la gcloud CLI pour obtenir un jeton OAuth 2.0 et l'utiliser comme mot de passe lors de la connexion au port 6432. Pour en savoir plus, consultez S'authentifier avec un jeton OAuth 2.0.

• Authentification automatique : utilisez le proxy d'authentification AlloyDB avec l'option --auto-iam-authn ou activez l'authentification IAM de manière programmatique avec les connecteurs de langage AlloyDB.

Afficher les statistiques sur les pools de connexions gérés

Lorsque vous activez la mise en pool des connexions gérées sur votre instance AlloyDB, vous pouvez vous connecter à la console de statistiques intégrée pour afficher des informations détaillées en temps réel sur vos pools de connexions. Vous pouvez accéder à la console de statistiques sur le port 6432 via une adresse IP privée à l'aide de l'accès aux services privés ou de Private Service Connect. La console de statistiques est utile pour surveiller les connexions actives ou inactives, résoudre les problèmes de temps d'attente et optimiser la taille des pools.

Pour utiliser la console de statistiques, procédez comme suit :

1. Par défaut, aucun utilisateur de base de données n'est autorisé à accéder à la console de statistiques. Vous devez utiliser la Google Cloud CLI pour spécifier les utilisateurs de la base de données qui peuvent se connecter, ce qui les ajoute à la liste d'autorisation pour l'accès à la console de statistiques.

   Pour ajouter un utilisateur de la console de statistiques, utilisez la commande gcloud alloydb instances update :

   gcloud alloydb instances update INSTANCE_ID \
   --project=PROJECT_ID \
   --region=REGION_ID \
   --cluster=CLUSTER_ID \
   --connection-pooling-stats-users=STATS_USERS
   

   Remplacez les éléments suivants :

   • INSTANCE_ID : nom de l'instance AlloyDB pour laquelle vous souhaitez autoriser les utilisateurs de la console de statistiques.
   • STATS_USERS : liste de noms d'utilisateurs de base de données, séparés par une virgule.
   • PROJECT_ID : ID du projet
   • REGION_ID : ID de la région.
   • CLUSTER_ID : ID du cluster.

2. Connectez-vous à l'instance sur le port 6432. Chaque instance de pooler de connexions gère ses propres métriques dans une base de données numérotée de manière unique. Spécifiez la base de données de statistiques pertinente pour le pooler que vous souhaitez surveiller :

   • Pour les poolers standards, utilisez alloydb_mcp_stats_POOLER_ID. L'ID est 1, jusqu'au nombre de poolers exécutés sur l'instance.
   • Pour le pooler du proxy d'authentification, utilisez alloydb_mcp_stats_authproxy_pooler1.
   Remarque : La base de données de la console de statistiques du pooler du proxy d'authentification n'est accessible qu'en se connectant à l'aide du client du proxy d'authentification.

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

   Remplacez les éléments suivants :

   • POOLER_ID : ID du pooler de connexions. L'ID est 1, jusqu'au nombre de poolers exécutés sur l'instance.
   • USERNAME : nom d'utilisateur de la base de données pour se connecter à l'instance AlloyDB.
   • PASSWORD : mot de passe de l'utilisateur.
   • IP_ADDRESS : adresse IP de l'instance AlloyDB. Il doit s'agir d'une adresse Private Service Connect (PSC) ou d'une adresse d'accès aux services privés (PSA).

3. Une fois connecté, exécutez des commandes SHOW compatibles avec PgBouncer pour afficher les métriques, par exemple :

   • SHOW STATS; : affiche des statistiques générales pour chaque base de données.
   • SHOW POOLS; : liste l'état de tous les pools de connexions actuels.
   • SHOW CLIENTS; : affiche des informations sur les connexions client actuelles.

Pour obtenir la liste complète des commandes disponibles, consultez la documentation officielle de PgBouncer.

Modifier le regroupement de connexions géré pour une instance

Après avoir activé le regroupement de connexions géré, vous pouvez personnaliser les options de regroupement de connexions géré pour répondre aux besoins de votre instance à l'aide des options de configuration avancées. Ces options de configuration sont appelées options de regroupement de connexions gérées. Pour en savoir plus, consultez Options de configuration avancées. Ces options s'appliquent également au pooler du proxy d'authentification AlloyDB.

Vous pouvez modifier les options de configuration de la mise en commun des connexions gérées pour une instance existante à l'aide de la console Google Cloud , de la Google Cloud CLI ou de l'API AlloyDB.

Console

1. Accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur un cluster dans la colonne Nom de la ressource.

3. Sur la page Présentation, accédez à Instances dans votre cluster.

4. Cliquez sur Modifier l'instance ou Modifier le pool de lecture pour l'instance que vous souhaitez modifier.

5. Sous Pool de connexions géré, développez Options de pooling avancées.

6. Modifiez les options de pooling avancées que vous souhaitez mettre à jour. Vous pouvez modifier les options suivantes :

   • Mode de connexion
   • Taille maximale du pool
   • Taille minimale du regroupement
   • Nombre maximal de connexions client
   • Délai d'inactivité des connexions client(s)
   • Délai d'inactivité des connexions au serveur(s)
   • Délai d'attente avant expiration des requêtes(s)
   • Nombre maximal d'instructions préparées
   • Ignorer les paramètres de démarrage
   • Durée de vie des serveurs(s)

7. Cliquez sur Mettre à jour l'instance.

gcloud

Pour modifier les options de configuration du pool de connexions géré pour une instance existante, utilisez la commande gcloud alloydb instances update suivante :

  gcloud 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_CONNECTIONS \
      | --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 \
      | --connection-pooling-max-prepared-statements=MAX_PREPARED_STATEMENTS \
      | --connection-pooling-server-lifetime=SERVER_LIFETIME \
      | --connection-pooling-client-connection-idle-timeout=CLIENT_CONNECTION_IDLE_TIMEOUT \
    }

Remplacez les éléments suivants :

• INSTANCE_ID : nom de l'instance AlloyDB pour laquelle vous souhaitez modifier les options de pooling de connexions géré.
• PROJECT_ID : ID du projet
• REGION_ID : ID de la région.
• CLUSTER_ID : ID du cluster.

• Vous pouvez configurer les options suivantes :

  • --connection-pooling-pool-mode : doit être défini sur session ou transaction.
  • --connection-pooling-max-pool-size
  • --connection-pooling-min-pool-size
  • --connection-pooling-max-client-connections
  • --connection-pooling-server-idle-timeout
  • --connection-pooling-query-wait-timeout
  • --connection-pooling-ignore-startup-parameters
  • --connection-pooling-max-prepared-statements
  • --connection-pooling-server-lifetime
  • --connection-pooling-client-connection-idle-timeout

REST

Pour modifier les options de configuration du regroupement de connexions géré pour une instance existante, utilisez la commande suivante et définissez connectionPoolConfig :

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID du projet
• LOCATION_ID : ID de la région du cluster.
• CLUSTER_ID : ID du cluster. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.
• INSTANCE_ID : ID de l'instance

• Vous pouvez configurer les options suivantes :

  • POOL_MODE : doit être défini sur session ou transaction.
  • MAX_POOL_SIZE
  • MIN_POOL_SIZE
  • MAX_CLIENT_CONNECTIONS
  • SERVER_IDLE_TIMEOUT
  • QUERY_WAIT_TIMEOUT
  • IGNORE_STARTUP_PARAMETERS
  • MAX_PREPARED_STATEMENTS
  • SERVER_LIFETIME
  • CLIENT_CONNECTION_IDLE_TIMEOUT
  • STATS_USERS

Méthode HTTP et URL :

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

Corps JSON de la requête :

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connections": "MAX_CLIENT_CONNECTIONS",
      "server_connection_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS",
      "max_prepared_statements": "MAX_PREPARED_STATEMENTS",
      "server_lifetime": "SERVER_LIFETIME",
      "client_connection_idle_timeout": "CLIENT_CONNECTION_IDLE_TIMEOUT",
      "stats_users": "STATS_USERS"
    }
  }
}

Afficher l'état du pooling de connexions géré pour une instance

Vous pouvez afficher l'état de la mise en pool des connexions gérées pour une instance à l'aide de la console Google Cloud , de la Google Cloud CLI ou de l'API AlloyDB.

Console

1. Accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur un cluster dans la colonne Nom de la ressource.

3. Sur la page Présentation, recherchez l'instance pour laquelle vous souhaitez afficher l'état du regroupement de connexions géré. Le champ Mise en pool des connexions gérées indique si elle est activée ou désactivée.

gcloud

Pour afficher l'état de la mise en pool des connexions gérées pour une instance existante, utilisez la commande gcloud alloydb instances describe suivante :

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

Remplacez les éléments suivants :

• INSTANCE_ID : nom de l'instance AlloyDB pour laquelle vous souhaitez afficher l'état du regroupement de connexions géré.
• PROJECT_ID : ID du projet
• REGION_ID : ID de la région.
• CLUSTER_ID : ID du cluster.

Si le regroupement de connexions géré est activé, la réponse suivante est renvoyée :

True

REST

Pour afficher l'état de la mise en pool de connexions gérée pour votre instance AlloyDB, utilisez la commande suivante et recherchez connectionPoolConfig :

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID du projet
• LOCATION_ID : ID de la région du cluster.
• CLUSTER_ID : ID du cluster. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.
• INSTANCE_ID : ID de l'instance

Méthode HTTP et URL :

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

Désactiver le pooling de connexions géré pour une instance existante

Vous pouvez désactiver le regroupement de connexions géré pour une instance existante à l'aide de la consoleGoogle Cloud , de la Google Cloud CLI ou de l'API AlloyDB.

Console

1. Accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur un cluster dans la colonne Nom de la ressource.

3. Sur la page Présentation, accédez à Instances dans votre cluster.

4. Cliquez sur Modifier l'instance ou Modifier le pool de lecture pour l'instance pour laquelle vous souhaitez désactiver le pooling de connexions géré.

5. Sous Pool de connexions géré, décochez la case Activer le pool de connexions géré.

6. Cliquez sur Mettre à jour l'instance.

   Remarque : Une fois que vous avez désactivé le regroupement de connexions géré, toutes les connexions établies avec le regroupement de connexions géré sont supprimées.

gcloud

Pour désactiver la mise en pool des connexions gérées pour une instance existante, utilisez la commande gcloud alloydb instances update suivante :

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

Remplacez les éléments suivants :

• INSTANCE_ID : nom de l'instance AlloyDB pour laquelle vous souhaitez désactiver la mise en pool des connexions gérées.
• PROJECT_ID : ID du projet
• REGION_ID : ID de la région.
• CLUSTER_ID : ID du cluster.

REST

Pour désactiver la mise en pool des connexions gérées pour une instance existante, utilisez la commande suivante et définissez connectionPoolConfig.enabled sur false :

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID du projet
• LOCATION_ID : ID de la région du cluster.
• CLUSTER_ID : ID du cluster. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.
• INSTANCE_ID : ID de l'instance

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Surveiller le regroupement de connexions géré

AlloyDB fournit les métriques suivantes pour vous aider à surveiller l'exécution du regroupement de connexions géré sur votre instance. Chaque métrique est associée à l'ID du pooler. Vous pouvez afficher ces métriques à l'aide de l'explorateur de métriques.

Nom de la métrique	Description
Nombre de pools de connexions /database/conn_pool/num_pools	Nombre total de pools de connexions par base de données.
Connexions client /database/conn_pool/client_connections	Suit le nombre de connexions client regroupées par état de la connexion client par base de données. Les états inclus dans cette métrique sont les suivants : active : nombre de connexions actives par base de données, y compris les clients inactifs qui n'ont pas de requêtes en attente. waiting : nombre de clients en attente d'une connexion au serveur par base de données.
Connexions au serveur /database/conn_pool/server_connections	Suit le nombre de connexions au serveur, regroupées par état de la connexion au serveur, par base de données. Les états inclus dans cette métrique sont les suivants : active : nombre de connexions actives par base de données. idle : nombre de connexions de serveur inactives par base de données.
Temps d'attente moyen /database/conn_pool/client_connections_avg_wait_time	Temps moyen passé par tous les clients en état d'attente pour un serveur, en microsecondes par base de données.

Pour en savoir plus, consultez Métriques AlloyDB.

Limites

Les limites suivantes s'appliquent :

• Si vous utilisez le regroupement de connexions géré en mode de regroupement de transactions, les fonctionnalités SQL suivantes ne sont pas compatibles :
  • SET/RESET
  • LISTEN
  • WITH HOLD CURSOR
  • PREPARE/DEALLOCATE
  • PRESERVE/DELETE ROW table temporaire
  • LOAD
  • Verrous consultatifs au niveau de la session
  • Plans préparés au niveau du protocole
• Le regroupement de connexions géré n'est pas compatible avec les connexions IP publiques.
• Les connexions des utilisateurs disposant du rôle PostgreSQL REPLICATION ne sont pas acceptées.