Configurare il pool di connessioni gestito

Questa pagina descrive come attivare, connetterti e monitorare il pooling delle connessioni gestite in AlloyDB per PostgreSQL. Il pool di connessioni gestito è un pattern di progettazione che ottimizza la gestione delle connessioni al database mantenendo un pool di connessioni prestabilite. Questo pool di connessioni viene poi riutilizzato dall'applicazione anziché aprire e chiudere le connessioni per ogni operazione del database, il che migliora le prestazioni e l'utilizzo delle risorse.

Con il pool di connessioni gestito, puoi scalare i workload del database ottimizzando l'utilizzo delle risorse e la latenza di connessione per le istanze AlloyDB. Il pool di connessioni gestito assegna dinamicamente le connessioni al server alle richieste in arrivo, se possibile, utilizzando il pooling e il multiplexing. Questo approccio consente di migliorare le prestazioni, in particolare per le connessioni scalate, assorbendo i picchi improvvisi delle connessioni e riutilizzando le connessioni al database esistenti. Quando utilizzi il pooling delle connessioni gestite, anziché connettersi a un database specifico, un'applicazione si connette a un pooler, che offre tempi di connessione più brevi e scalabilità per i tuoi carichi di lavoro di lettura.

Sebbene tu possa utilizzare il pooling delle connessioni gestito per qualsiasi carico di lavoro transazionale, il pooling delle connessioni gestito è più adatto per le applicazioni che contengono più connessioni di breve durata o per le applicazioni che potrebbero registrare un picco di connessioni.

Prima di iniziare

Devi connetterti all'istanza utilizzando una connessione diretta. Il pooling delle connessioni gestite non supporta la connessione con il proxy di autenticazione AlloyDB o i connettori dei linguaggi AlloyDB.

Ruoli obbligatori

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

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

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

Opzioni di configurazione avanzate

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

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

Abilita il pooling delle connessioni gestite

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

Attivare per una nuova istanza principale

Per creare una nuova istanza principale con il pooling delle connessioni gestite abilitato, consulta Creare un'istanza principale. Puoi attivare il pooling delle connessioni gestite per un'istanza utilizzando la console Google Cloud, Google Cloud CLI o l'API AlloyDB.

Attivare per una nuova istanza del pool di lettura

Per creare una nuova istanza del pool di lettura con il pooling delle connessioni gestito abilitato, consulta Creare un'istanza del pool di lettura. Puoi attivare il pooling delle connessioni gestite per un'istanza utilizzando la console Google Cloud, Google Cloud CLI o l'API AlloyDB.

Attivare per un'istanza esistente

Puoi attivare il pooling delle connessioni gestite per un'istanza esistente utilizzando la console Google Cloud, Google Cloud CLI o l'API 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
  }
}

Connettiti al pool di connessioni gestito

La connessione al pool di connessioni gestito è identica alle connessioni dirette al database, tranne che su una porta diversa. Il pooling delle connessioni gestito ascolta sulla porta 6432. Qualsiasi utente aggiunto all'istanza AlloyDB può connettersi utilizzando il pooling delle connessioni gestite.

Eseguire la connessione utilizzando l'autenticazione integrata

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

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

Connettiti utilizzando connessioni SSL

La modalità SSL dell'istanza si applica anche a qualsiasi connessione al pool di connessioni gestito. Per impostazione predefinita, vengono accettate solo le connessioni SSL. Per consentire le 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

Modificare il pooling delle connessioni gestite per un'istanza

Dopo aver attivato 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 avanzata. Queste opzioni di configurazione sono chiamate flag di pooling delle connessioni gestite. Per ulteriori informazioni sulle opzioni di configurazione, sui relativi valori predefiniti e sugli intervalli, consulta le opzioni di configurazione avanzata.

Puoi modificare le opzioni di configurazione del pooling delle connessioni gestite per un'istanza esistente utilizzando la console Google Cloud, Google Cloud CLI o l'API 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"
    },
  }
}

Visualizzare 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.

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

Disattivare il pooling delle connessioni gestite per un'istanza esistente

Puoi disattivare il pooling delle connessioni gestite per un'istanza esistente utilizzando la console Google Cloud, Google Cloud CLI o l'API 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
  }
}

Monitorare il pool di connessioni gestito

AlloyDB fornisce le seguenti metriche per aiutarti a monitorare il funzionamento del pooling delle connessioni gestite nella tua istanza. Puoi visualizzare queste metriche utilizzando Metrics Explorer.

Per ulteriori informazioni, consulta Metriche di AlloyDB.

Limitazioni

Le seguenti limitazioni si applicano durante la release Preview e sono soggette a modifiche o rimozione al momento della release GA o successivamente:

• Il pooling delle connessioni gestite non supporta la connessione con AlloyDB Auth Proxy o i connettori dei linguaggi AlloyDB.
• Se utilizzi il pooling delle connessioni gestite nella 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 consulenza a livello di sessione
  • Piani preparati a livello di protocollo