Configurare il pool di connessioni gestito

Per scalare i workload AlloyDB per PostgreSQL, assorbire picchi di connessione improvvisi e ridurre la latenza di connessione, puoi abilitare il pooling delle connessioni gestite. Il pool di connessioni gestito mantiene un pool di connessioni server prestabilite e multiplexa dinamicamente le richieste client in entrata tra queste connessioni, anziché aprire e chiudere una connessione di backend per ogni operazione del database.

Anziché connettersi direttamente al backend del database, l'applicazione si connette a un pooler, che offre tempi di connessione più brevi e una migliore scalabilità per i workload di lettura e scrittura. Sebbene sia possibile utilizzare il pool di connessioni gestito per qualsiasi workload transazionale, è più adatto per le applicazioni che utilizzano connessioni di breve durata o che subiscono picchi di connessione.

Nota: il pooling delle connessioni gestite è disabilitato per impostazione predefinita.

Prima di iniziare

Il pool di connessioni gestito supporta anche le connessioni con il proxy di autenticazione AlloyDB o gli AlloyDB Language Connector.

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per abilitare e utilizzare il pooling delle connessioni gestite, chiedi all'amministratore di concederti il ruolo IAM Amministratore AlloyDB (roles/alloydb.admin) nell'istanza AlloyDB. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione alloydb.instances.update, necessaria per abilitare e utilizzare il pooling delle connessioni gestite.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Opzioni di configurazione avanzate

Il pool di connessioni gestito di AlloyDB supporta le seguenti opzioni di configurazione avanzata del pool. Puoi personalizzare il pool di connessioni gestite per soddisfare le esigenze della tua istanza impostando queste configurazioni a livello di istanza utilizzando la console Google Cloud , gcloud CLI o l'API AlloyDB.

Nome configurazione	Descrizione
Modalità di connessione (connection-pooling-pool-mode)	Per la modalità di connessione, puoi selezionare transazione (predefinita) o sessione. Transazione (transaction): Raggruppa le connessioni a livello di transazione. Durante una transazione, a un client viene assegnata una connessione al server. Al termine della transazione, la connessione al server viene reinserita nel pool. Sessione (session): Raggruppa le connessioni a livello di sessione. Al client viene assegnata una connessione al server per tutto il tempo in cui rimane connesso. Dopo la disconnessione del client, la connessione al server viene reinserita nel pool.
Dimensioni massime del pool (connection-pooling-max-pool-size)	La dimensione massima del pool di connessioni per coppia di utenti e database. Questo valore può variare da 1 a 262,042 connessioni e il valore predefinito è 50 connessioni.
Dimensioni minime del pool (connection-pooling-min-pool-size)	La dimensione minima del pool di connessioni. Questo valore può variare da 0 a 262,042 connessioni e il valore predefinito è 0 connessioni.
Numero massimo di connessioni client (connection-pooling-max-client-connections)	Numero massimo di connessioni client simultanee consentite. Questo valore può variare da 1 a 262,042 connessioni e il valore predefinito è 5000 connessioni.
Timeout di connessione client inattivo(sec) (connection-pooling-client-connection-idle-timeout)	Il tempo durante il quale una connessione client rimane inattiva prima del timeout. Questo valore può variare da 0 a 2,147,483 secondi e il valore predefinito è 0 secondi.
Timeout di connessione al server inattivo(sec) (connection-pooling-server-idle-timeout)	Il tempo durante il quale una connessione al server rimane inattiva prima del timeout. Questo valore può variare da 0 a 2,147,483 secondi e il valore predefinito è 600 secondi.
Timeout di attesa della query(sec) (connection-pooling-query-wait-timeout)	Il tempo di attesa di una query prima del timeout. Questo valore può variare da 0 a 2,147,483 secondi e il valore predefinito è 120 secondi.
Istruzioni preparate massime (connection-pooling-max-prepared-statements)	Il numero massimo di comandi di istruzioni preparate inviati in modalità di pooling delle transazioni. Questo valore può essere compreso tra 0 e 262,042 e il valore predefinito è 0.
Ignora parametri di avvio (connection-pooling-ignore-startup-parameters)	Un elenco separato da virgole di parametri di avvio che il pooler ignora quando non vengono monitorati nei pacchetti di avvio per impostazione predefinita. Il valore predefinito è extra_float_digits.
Durata dei server (connection-pooling-server-lifetime)	Il tempo massimo di inutilizzo di una connessione al server prima che il pooling delle connessioni gestite la chiuda. Questo valore può variare da 0 a 2,147,483 secondi e il valore predefinito è 3600 secondi.
Utenti con ruolo Visualizzatore statistiche (connection-pooling-stats-users)	Un elenco separato da virgole di utenti del database autorizzati a connettersi alla console delle statistiche. Questo parametro può essere configurato utilizzando Google Cloud CLI o l'API AlloyDB. Gli utenti autorizzati possono accedere alle metriche avanzate, che vengono conservate nel database alloydb_mcp_stats_{pooler_id} per ogni pooler.

Per impostazione predefinita, il pool di connessioni gestito avvia le connessioni al server AlloyDB. Quando viene stabilita e autenticata una connessione client, il pool di connessioni gestite potrebbe creare una o più connessioni server in modo che le dimensioni del pool corrispondano alla configurazione scelta. Alla connessione client viene quindi assegnata una connessione server disponibile. Le connessioni al server vengono mantenute finché non vengono chiuse esplicitamente o finché non rimangono inattive per un periodo di tempo superiore al timeout di connessione al server inattivo.

Quando abiliti il pooling delle connessioni gestite, anche le connessioni del server proxy di autenticazione AlloyDB vengono raggruppate in un pool separato che include solo le connessioni in pool con il proxy di autenticazione AlloyDB abilitato.

Abilita il pool di connessioni gestito

Nota: l'abilitazione del pool di connessioni gestite sulle istanze AlloyDB create prima di novembre 2024 richiede un aggiornamento una tantum delle impostazioni della rete. Questo aggiornamento comporta una breve interruzione della connettività di rete VPC, che in genere dura meno di 15 secondi. L'IP pubblico non è interessato. Il database non verrà riavviato durante questo processo.

Puoi abilitare il pool di connessioni gestito per qualsiasi istanza esistente o nuova.

Abilita per una nuova istanza principale

Per creare una nuova istanza principale con il pooling delle connessioni gestite abilitato, consulta Crea un'istanza principale. Puoi abilitare il pool di connessioni gestite per un'istanza utilizzando la consoleGoogle Cloud , Google Cloud CLI o l'API AlloyDB.

Abilita per una nuova istanza del pool di lettura

Per creare una nuova istanza del pool di lettura con il pool di connessioni gestito abilitato, consulta Crea un'istanza del pool di lettura. Puoi abilitare il pool di connessioni gestite per un'istanza utilizzando la consoleGoogle Cloud , Google Cloud CLI o l'API AlloyDB.

Abilita per un'istanza esistente

Puoi abilitare il pool di connessioni gestite per un'istanza esistente utilizzando la consoleGoogle Cloud , Google Cloud CLI o l'API AlloyDB.

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Nella pagina Panoramica, vai a Istanze nel tuo cluster.

4. Fai clic su Modifica istanza principale o Modifica pool di lettura.

5. In Pool di connessioni gestito, seleziona la casella di controllo Abilita pool di connessioni gestito.

6. (Facoltativo) Per configurare le opzioni di pooling delle connessioni gestite, fai clic su Opzioni avanzate di pooling.

   Puoi personalizzare le opzioni del pool di connessioni gestito per soddisfare le esigenze della tua istanza. Per saperne di più, consulta Opzioni di configurazione avanzata.

7. Fai clic su Salva modifiche.

gcloud

Per abilitare il pool di connessioni gestito per un'istanza principale o di pool di lettura esistente, utilizza il seguente comando gcloud alloydb instances update:

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

Sostituisci quanto segue:

• INSTANCE_ID: l'ID dell'istanza AlloyDB per cui vuoi abilitare il pooling delle connessioni gestite.
• PROJECT_ID: l'ID del progetto
• REGION_ID: l'ID della regione.
• CLUSTER_ID: l'ID del cluster.

Dopo aver abilitato il pool di connessioni gestito, puoi personalizzare le opzioni del pool di connessioni gestito in base alle esigenze della tua istanza impostando le opzioni di configurazione avanzate. Per saperne di più su come impostare le opzioni di configurazione, consulta Modifica il pool di connessioni gestite per un'istanza.

REST

Per abilitare il pool di connessioni gestito per un'istanza del pool principale o di lettura esistente, utilizza il seguente comando e imposta connectionPoolConfig:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID del progetto
• LOCATION_ID: l'ID della regione del cluster.
• CLUSTER_ID: l'ID del cluster. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
• INSTANCE_ID: l'ID dell'istanza.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Connettiti al pool di connessioni gestito

La connessione al pool di connessioni gestito è identica alle connessioni dirette al database, ad eccezione di una porta diversa. Il pool di connessioni gestito è in ascolto sulla porta 6432. Qualsiasi utente aggiunto all'istanza AlloyDB può connettersi utilizzando il pool di connessioni gestite.

Connettiti utilizzando l'autenticazione integrata

L'esempio di comando connette l'istanza AlloyDB al pool di connessioni gestite utilizzando l'autenticazione integrata.

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

Sostituisci quanto segue:

• USERNAME: il nome utente del database per connettersi all'istanza AlloyDB.
• PASSWORD: la password dell'utente.
• IP_ADDRESS: l'indirizzo IP dell'istanza AlloyDB.

Nota: le connessioni di utenti con il ruolo REPLICATION non sono supportate.

Connettiti utilizzando connessioni SSL

La modalità SSL dell'istanza si applica anche a tutte le connessioni al pool di connessioni gestite. Per impostazione predefinita, sono accettate solo le connessioni SSL. Per consentire connessioni non criptate, utilizza il seguente comando gcloud alloydb instances update per impostare la modalità SSL dell'istanza su 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

Connettiti utilizzando l'autenticazione IAM

Puoi connetterti al pool di connessioni gestite utilizzando l'autenticazione IAM in uno dei due modi seguenti:

• Autenticati con un token OAuth 2.0: utilizza gcloud CLI per ottenere un token OAuth 2.0 e utilizzalo come password per la connessione alla porta 6432. Per saperne di più, consulta Esegui l'autenticazione con un token OAuth 2.0.

• Autenticati automaticamente: utilizza il proxy di autenticazione AlloyDB con il flag --auto-iam-authn o abilita l'autenticazione IAM in modo programmatico con gli AlloyDB Language Connector.

Visualizza le statistiche sui pool di connessioni gestiti

Quando attivi il pool di connessioni gestite sulla tua istanza AlloyDB, puoi connetterti alla console delle statistiche integrata per visualizzare informazioni dettagliate in tempo reale sui tuoi pool di connessioni. Puoi accedere alla console delle statistiche sulla porta 6432 tramite un indirizzo IP privato utilizzando l'accesso privato ai servizi o Private Service Connect. La console delle statistiche è utile per monitorare le connessioni attive o inattive, risolvere i problemi relativi ai tempi di attesa e ottimizzare le dimensioni del pool.

Per utilizzare la console delle statistiche, segui questi passaggi:

1. Per impostazione predefinita, nessun utente del database è autorizzato ad accedere alla console delle statistiche. Devi utilizzare Google Cloud CLI per specificare quali utenti del database possono connettersi, inserendoli nella lista consentita per l'accesso alla console di Statistiche.

   Per aggiungere un utente della console delle statistiche, utilizza il comando 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
   

   Sostituisci quanto segue:

   • INSTANCE_ID: il nome dell'istanza AlloyDB per cui vuoi autorizzare gli utenti della console di statistiche.
   • STATS_USERS: un elenco separato da virgole di nomi utente del database.
   • PROJECT_ID: l'ID del progetto
   • REGION_ID: l'ID della regione.
   • CLUSTER_ID: l'ID del cluster.

2. Connettiti all'istanza sulla porta 6432. Ogni singola istanza del pooler di connessioni gestisce le proprie metriche in un database numerato in modo univoco. Specifica il database delle statistiche pertinente per il pooler che vuoi monitorare:

   • Per i pooler standard, utilizza alloydb_mcp_stats_POOLER_ID. L'ID è 1, fino al numero di pooler in esecuzione nell'istanza.
   • Per il pooler proxy di autenticazione, utilizza alloydb_mcp_stats_authproxy_pooler1.
   Nota: il database della console delle statistiche del pooler del proxy di autenticazione è raggiungibile solo connettendosi tramite il client del proxy di autenticazione.

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

   Sostituisci quanto segue:

   • POOLER_ID: l'ID del pooler di connessioni. L'ID è 1, fino al numero di pooler in esecuzione sull'istanza.
   • USERNAME: il nome utente del database per connettersi all'istanza AlloyDB.
   • PASSWORD: la password dell'utente.
   • IP_ADDRESS: l'indirizzo IP dell'istanza AlloyDB. Deve essere un indirizzo Private Service Connect (PSC) o di accesso privato ai servizi (PSA).

3. Dopo aver eseguito la connessione, esegui i comandi SHOW compatibili con PgBouncer per visualizzare le metriche, ad esempio:

   • SHOW STATS;: visualizza le statistiche generali per ogni database.
   • SHOW POOLS;: elenca lo stato di tutti i pool di connessioni attuali.
   • SHOW CLIENTS;: mostra informazioni sulle connessioni client correnti.

Per un elenco completo dei comandi disponibili, consulta la documentazione ufficiale di PgBouncer.

Modifica il pool di connessioni gestito per un'istanza

Dopo aver abilitato il pool di connessioni gestito, puoi personalizzare le opzioni del pool di connessioni gestito in base alle esigenze della tua istanza utilizzando le opzioni di configurazione avanzate. Queste opzioni di configurazione sono chiamate flag di pooling delle connessioni gestite. Per saperne di più, consulta Opzioni di configurazione avanzata. Queste opzioni si applicano anche al pooler del proxy di autenticazione AlloyDB.

Puoi modificare le opzioni di configurazione del pool di connessioni gestite per un'istanza esistente utilizzando la console Google Cloud , Google Cloud CLI o l'API AlloyDB.

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Nella pagina Panoramica, vai a Istanze nel tuo cluster.

4. Fai clic su Modifica istanza o Modifica pool di lettura per l'istanza che vuoi modificare.

5. In Pool di connessioni gestito, espandi Opzioni di pooling avanzate.

6. Modifica le opzioni di pooling avanzate che vuoi aggiornare. Puoi modificare le seguenti opzioni:

   • Modalità di connessione
   • Dimensioni massime del pool
   • Dimensioni minime del pool
   • Numero massimo di connessioni client
   • Timeout di connessione client inattivo(sec)
   • Timeout di connessione al server inattivo(sec)
   • Timeout di attesa della query(sec)
   • Istruzioni preparate massime
   • Ignora parametri di avvio
   • Durata dei server

7. Fai clic su Aggiorna istanza.

gcloud

Per modificare le opzioni di configurazione del pool di connessioni gestite per un'istanza esistente, utilizza il seguente comando gcloud alloydb instances update:

  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 \
    }

Sostituisci quanto segue:

• INSTANCE_ID: il nome dell'istanza AlloyDB per cui vuoi modificare le opzioni di pool di connessioni gestite.
• PROJECT_ID: l'ID del progetto
• REGION_ID: l'ID della regione.
• CLUSTER_ID: l'ID del cluster.

• Puoi configurare le seguenti opzioni:

  • --connection-pooling-pool-mode. Deve essere session o 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

Per modificare le opzioni di configurazione del pool di connessioni gestite per un'istanza esistente, utilizza il seguente comando e imposta connectionPoolConfig:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID del progetto
• LOCATION_ID: l'ID della regione del cluster.
• CLUSTER_ID: l'ID del cluster. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
• INSTANCE_ID: l'ID dell'istanza.

• Puoi configurare le seguenti opzioni:

  • POOL_MODE. Deve essere session o 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

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "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"
    }
  }
}

Visualizza lo stato del pool di connessioni gestito per un'istanza

Puoi visualizzare lo stato del pooling delle connessioni gestite per un'istanza utilizzando la console Google Cloud , Google Cloud CLI o l'API AlloyDB.

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Nella pagina Panoramica, individua l'istanza per cui vuoi visualizzare lo stato del pool di connessioni gestite. Il campo Pool di connessioni gestito mostra se è abilitato o disabilitato.

gcloud

Per visualizzare lo stato del pool di connessioni gestite per un'istanza esistente, utilizza il seguente comando gcloud alloydb instances describe:

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

Sostituisci quanto segue:

• INSTANCE_ID: il nome dell'istanza AlloyDB per cui vuoi visualizzare lo stato del pool di connessioni gestite.
• PROJECT_ID: l'ID del progetto
• REGION_ID: l'ID della regione.
• CLUSTER_ID: l'ID del cluster.

Se il pool di connessioni gestito è abilitato, viene restituita la seguente risposta:

True

REST

Per visualizzare lo stato del pool di connessioni gestite per la tua istanza AlloyDB, utilizza il seguente comando e cerca connectionPoolConfig:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID del progetto
• LOCATION_ID: l'ID della regione del cluster.
• CLUSTER_ID: l'ID del cluster. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
• INSTANCE_ID: l'ID dell'istanza.

Metodo HTTP e URL:

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

Disabilita il pool di connessioni gestito per un'istanza esistente

Puoi disabilitare il pool di connessioni gestite per un'istanza esistente utilizzando la consoleGoogle Cloud , Google Cloud CLI o l'API AlloyDB.

Console

1. Vai alla pagina Cluster.

   Vai a Cluster

2. Fai clic su un cluster nella colonna Nome risorsa.

3. Nella pagina Panoramica, vai a Istanze nel tuo cluster.

4. Fai clic su Modifica istanza o Modifica pool di lettura per l'istanza per cui vuoi disattivare il pool di connessioni gestito.

5. In Pool di connessioni gestito, deseleziona la casella di controllo Abilita pool di connessioni gestito.

6. Fai clic su Aggiorna istanza.

   Nota: Dopo aver disabilitato il pool di connessioni gestito, tutte le connessioni effettuate al pool di connessioni gestito vengono interrotte.

gcloud

Per disattivare il pooling delle connessioni gestite per un'istanza esistente, utilizza il seguente comando gcloud alloydb instances update:

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

Sostituisci quanto segue:

• INSTANCE_ID: il nome dell'istanza AlloyDB per cui vuoi disattivare il pooling delle connessioni gestite.
• PROJECT_ID: l'ID del progetto
• REGION_ID: l'ID della regione.
• CLUSTER_ID: l'ID del cluster.

REST

Per disattivare il pooling delle connessioni gestite per un'istanza esistente, utilizza il seguente comando e imposta connectionPoolConfig.enabled su false:

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID del progetto
• LOCATION_ID: l'ID della regione del cluster.
• CLUSTER_ID: l'ID del cluster. Deve iniziare con una lettera minuscola e può contenere lettere minuscole, numeri e trattini.
• INSTANCE_ID: l'ID dell'istanza.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Monitora il pool di connessioni gestito

AlloyDB fornisce le seguenti metriche per aiutarti a monitorare l'esecuzione del pool di connessioni gestito sulla tua istanza. Ogni metrica è etichettata con l'ID del pooler. Puoi visualizzare queste metriche utilizzando Metrics Explorer.

Nome metrica	Descrizione
Numero di pool di connessioni /database/conn_pool/num_pools	Il numero totale di pool di connessioni per database.
Connessioni client /database/conn_pool/client_connections	Monitora il numero di connessioni client raggruppate in base allo stato della connessione client per database. Gli stati inclusi in questa metrica sono: active: il numero di connessioni attive per database, inclusi i client inattivi che non hanno richieste di query in attesa. waiting: il numero di client in attesa di una connessione al server per database.
Connessioni al server /database/conn_pool/server_connections	Monitora il numero di connessioni server raggruppate per stato della connessione server per database. Gli stati inclusi in questa metrica sono: active: il numero di connessioni attive per database. idle: il numero di connessioni server inattive per database.
Tempo medio di attesa /database/conn_pool/client_connections_avg_wait_time	Il tempo medio trascorso da tutti i client in stato di attesa per un server in microsecondi per database.

Per saperne di più, consulta Metriche di AlloyDB.

Limitazioni

Si applicano le seguenti limitazioni:

• Se utilizzi il pooling delle connessioni gestite in modalità di pooling delle transazioni, le seguenti funzionalità SQL non sono supportate:
  • SET/RESET
  • LISTEN
  • WITH HOLD CURSOR
  • PREPARE/DEALLOCATE
  • PRESERVE/DELETE ROW tabelle temporanee
  • LOAD
  • Blocchi di avviso a livello di sessione
  • Piani preparati a livello di protocollo
• Il pool di connessioni gestito non è supportato per le connessioni con IP pubblico.
• Le connessioni di utenti con il ruolo PostgreSQL REPLICATION non sono supportate.