Configurare il pool di connessioni gestito

Questa pagina descrive come attivare, connettersi e monitorare il pooling di connessioni gestito 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 riutilizzato dall'applicazione anziché aprire e chiudere le connessioni per ogni operazione del database, il che migliora le prestazioni e l'utilizzo delle risorse.

Utilizzando il pool di connessioni gestito, puoi scalare i carichi di lavoro del database ottimizzando l'utilizzo delle risorse e la latenza della connessione per le istanze AlloyDB. Il pool di connessioni gestito assegna dinamicamente le connessioni server alle richieste in entrata quando possibile utilizzando il pooling e il multiplexing. Questo approccio migliora le prestazioni, soprattutto per le connessioni scalate, assorbendo i picchi improvvisi di connessione e riutilizzando le connessioni al database esistenti. Anziché connettersi a un database specifico, quando utilizzi il pooling delle connessioni gestite, un'applicazione si connette a un pooler, che fornisce tempi di connessione più brevi e scalabilità per i carichi di lavoro di lettura.

Sebbene tu possa utilizzare il pool di connessioni gestito per qualsiasi carico di lavoro transazionale, il pool di connessioni gestito è più adatto alle applicazioni che contengono più connessioni di breve durata o alle applicazioni che potrebbero subire un aumento improvviso delle connessioni.

Prima di iniziare

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

Ruoli obbligatori

Per ottenere l'autorizzazione necessaria per abilitare e utilizzare il pooling delle connessioni gestito, chiedi all'amministratore di concederti il ruolo IAM Cloud AlloyDB Admin (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 pool di connessioni gestito.

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 avanzate del pool. 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 consoleGoogle Cloud , gcloud CLI o l'API AlloyDB.

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 gestito 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 rimangono inattive per un periodo di tempo superiore al timeout di connessione server inattivo.

Abilita il pool di connessioni gestito

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

Abilita per una nuova istanza primaria

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

Abilitare 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 la sezione Creazione di un'istanza del pool di lettura. Puoi abilitare il pooling di connessioni gestito per un'istanza utilizzando la consoleGoogle Cloud , Google Cloud CLI o l'API AlloyDB.

Abilitare per un'istanza esistente

Puoi attivare il pooling delle connessioni gestito per un'istanza esistente utilizzando la consoleGoogle 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
  }
}

Connettersi 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 pool di connessioni gestito è in ascolto sulla porta 6432. Qualsiasi utente aggiunto all'istanza AlloyDB può connettersi utilizzando il pool di connessioni gestito.

Connettersi utilizzando l'autenticazione integrata

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

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

Connessione tramite connessioni SSL

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

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 ulteriori informazioni sulle opzioni di configurazione, sui valori predefiniti e sugli intervalli, consulta Opzioni di configurazione avanzate.

Puoi modificare le opzioni di configurazione del pool di connessioni gestito 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 \
      | --connection-pooling-server-lifetime=SERVER_LIFETIME \
      | --connection-pooling-client-connection-idle-timeout=CLIENT_CONNECTION_IDLE_TIMEOUT \
    }

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

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

Puoi visualizzare lo stato del pool di connessioni gestito 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

Disabilitare il pool di connessioni gestito per un'istanza esistente

Puoi disattivare il pool di connessioni gestito per un'istanza esistente utilizzando la consoleGoogle 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 pool di connessioni gestito nella tua istanza. Puoi visualizzare queste metriche utilizzando Metrics Explorer.

Per ulteriori informazioni, consulta Metriche AlloyDB.

Limitazioni

Durante la release Anteprima si applicano le seguenti limitazioni, che sono soggette a modifiche o rimozione al momento della release GA o successivamente:

• Il pool di connessioni gestito non supporta la connessione con il proxy di autenticazione AlloyDB o i connettori dei linguaggi AlloyDB.
• Se utilizzi il pooling di connessioni gestito 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 avviso a livello di sessione
  • Piani preparati a livello di protocollo
• Il pool di connessioni gestito non è supportato per le connessioni IP pubbliche.