Questa pagina descrive come abilitare, configurare e monitorare il pool di connessioni gestite nelle istanze Cloud SQL.
Il pool di connessioni gestito consente di scalare i workload ottimizzando l'utilizzo delle risorse e la latenza di connessione per le istanze utilizzando il pool. Per informazioni dettagliate sul pool di connessioni gestito e su come utilizzarlo per le tue istanze, consulta la panoramica del pool di connessioni gestito.
Prima di iniziare
- Verifica che l'istanza soddisfi tutti i requisiti per utilizzare il pool di connessioni gestite.
- Se utilizzi gcloud CLI, verifica che la versione di gcloud CLI sia
515.0.0o successiva. - Verifica che l'istanza utilizzi la nuova architettura di rete di Cloud SQL. Se l'istanza utilizza ancora la vecchia architettura di rete, esegui l'upgrade alla nuova architettura di rete.
- Verifica che l'istanza disponga delle connessioni server per vCPU richieste allocate nel flag
max_connectionsper le impostazioni di configurazione del database. Per saperne di più, consulta Connessioni al server utilizzate dal pool di connessioni gestito.
Abilita il pool di connessioni gestito
Puoi attivare il pool di connessioni gestite per un'istanza al momento della creazione o modificare un'istanza esistente per attivarlo.
Abilita il pool di connessioni gestito per una nuova istanza
Per creare una nuova istanza con il pool di connessioni gestito abilitato, consulta Crea istanze. Puoi attivare il pooling delle connessioni gestite per una nuova istanza solo utilizzando gcloud CLI o l'API Cloud SQL.
Abilita il pool di connessioni gestito per un'istanza esistente
Per abilitare il pool di connessioni gestito per un'istanza esistente:
Console
Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.
Trova l'istanza per cui vuoi abilitare il pool di connessioni gestito. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.
Fai clic su Modifica.
In Personalizza la tua istanza, espandi Connessioni.
Per abilitare il pool di connessioni gestito, seleziona la casella Abilita pool di connessioni gestito.
Fai clic su Salva.
gcloud
Utilizza il comando gcloud sql instances per abilitare il pool di connessioni gestito.
gcloud sql instances patch INSTANCE_NAME \
--enable-connection-pooling
Sostituisci quanto segue:
INSTANCE_NAME: il nome dell'istanza Cloud SQL.
REST v1
Utilizza il seguente comando e imposta connectionPoolingEnabled:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Corpo JSON della richiesta:
{
"settings": {
"connectionPoolConfig": {
"connectionPoolingEnabled": true
}
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
REST v1beta4
Utilizza il seguente comando e imposta connectionPoolingEnabled:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Corpo JSON della richiesta:
{
"settings": {
"connectionPoolConfig": {
"connectionPoolingEnabled": true
}
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Terraform
Utilizza la seguente risorsa Terraform:
Modifica il pool di connessioni gestito per un'istanza
Dopo aver attivato il pool di connessioni gestito, puoi personalizzarlo per soddisfare le esigenze della tua istanza utilizzando le opzioni di configurazione avanzate. Queste opzioni di configurazione sono chiamate flag del pool di connessioni gestito. Le configurazioni aggiunte al pool di connessioni gestito vengono applicate per pooler di connessioni utilizzato dall'istanza. Un pooler di connessioni è un servizio di proxy del database che gestisce i pool di connessioni tra le applicazioni client e il server del database. Poiché Cloud SQL scala il numero di pooler di connessioni in base alle dimensioni dell'istanza (1 pooler di connessioni ogni 4 vCPU, con un minimo di 1 pooler di connessioni), determina i valori di configurazione in base alle dimensioni dell'istanza e ai requisiti delle dimensioni del pool. Per ulteriori informazioni sulle opzioni di configurazione avanzata, sui relativi valori predefiniti e sugli intervalli, consulta Opzioni di configurazione avanzata.
Per modificare le opzioni di configurazione avanzate del pool di connessioni gestito per un'istanza, segui questi passaggi:
Console
Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.
Trova l'istanza per cui vuoi abilitare il pool di connessioni gestito. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.
Fai clic su Modifica.
In Personalizza la tua istanza, espandi Connessioni.
In Pool di connessioni gestito, espandi Opzioni avanzate di pooling.
Modifica le opzioni avanzate di pooling che vuoi aggiornare.
Fai clic su Salva.
gcloud
Utilizza il comando gcloud sql instances per modificare le opzioni di configurazione.
gcloud sql instances patch INSTANCE_NAME \
--connection-pool-flags=CONFIGURATION_NAME=CONFIGURATION_VALUE
Sostituisci quanto segue:
INSTANCE_NAME: il nome dell'istanza Cloud SQL.CONFIGURATION_NAME: il nome dell'opzione di configurazione. Per un elenco di tutte le opzioni di configurazione avanzata, consulta Opzioni di configurazione avanzata.CONFIGURATION_VALUE: il nuovo valore per l'opzione di configurazione selezionata.
REST v1
Per modificare le configurazioni avanzate del pool di connessioni gestite, utilizza il seguente comando e imposta ConnectionPoolConfig:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Corpo JSON della richiesta:
{
"settings": {
"connectionPoolConfig": {
"flags":
[
{
"name": "CONFIGURATION_NAME",
"value":"CONFIGURATION_VALUE"
}
]
}
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
REST v1beta4
Per modificare le configurazioni avanzate del pool di connessioni gestite, utilizza il seguente comando e imposta ConnectionPoolConfig:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Corpo JSON della richiesta:
{
"settings": {
"connectionPoolConfig": {
"flags":
[
{
"name": "CONFIGURATION_NAME",
"value":"CONFIGURATION_VALUE"
}
]
}
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Terraform
Per modificare le configurazioni avanzate del pool di connessioni gestite, utilizza la seguente risorsa Terraform:
Disabilita il pool di connessioni gestito per un'istanza
Puoi disabilitare il pool di connessioni gestite per un'istanza esistente utilizzando la consoleCloud de Confiance , gcloud CLI o l'API Cloud SQL.
Per disabilitare il pool di connessioni gestito per un'istanza:
Console
Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.
Trova l'istanza per cui vuoi disabilitare il pool di connessioni gestito. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.
Fai clic su Modifica.
In Personalizza la tua istanza, espandi Connessioni.
Per disabilitare il pool di connessioni gestito, deseleziona la casella Abilita pool di connessioni gestito.
Fai clic su Salva.
gcloud
Utilizza il comando gcloud sql instances per disabilitare il pool di connessioni gestito.
gcloud sql instances patch INSTANCE_NAME \
--no-enable-connection-pooling
Sostituisci quanto segue:
PROJECT_ID: il nome dell'istanza Cloud SQL.
REST v1
Per disattivare il pool di connessioni gestite per un'istanza, utilizza il seguente comando e imposta connectionPoolingEnabled:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Corpo JSON della richiesta:
{
"settings": {
"connectionPoolConfig": {
"connectionPoolingEnabled": false
}
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
REST v1beta4
Per disattivare il pool di connessioni gestite per un'istanza, utilizza il seguente comando e imposta connectionPoolingEnabled:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID progetto
- INSTANCE_ID: l'ID istanza
Metodo HTTP e URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Corpo JSON della richiesta:
{
"settings": {
"connectionPoolConfig": {
"connectionPoolingEnabled": false
}
}
}
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#operation",
"targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
"status": "PENDING",
"user": "user@example.com",
"insertTime": "2020-01-16T02:32:12.281Z",
"operationType": "UPDATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
Terraform
Per disabilitare il pool di connessioni gestite per un'istanza, utilizza la seguente risorsa Terraform:
Visualizza lo stato del pool di connessioni gestito per un'istanza
Puoi visualizzare lo stato del pool di connessioni gestite per un'istanza utilizzando la console Cloud de Confiance , gcloud CLI o l'API Cloud SQL.
Per visualizzare lo stato del pool di connessioni gestite per un'istanza Cloud SQL Enterprise Plus, segui questi passaggi:
Console
Nella console Cloud de Confiance , vai alla pagina Istanze Cloud SQL.
Trova l'istanza per cui vuoi visualizzare lo stato del pool di connessioni gestito. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.
La sezione Connessioni mostra se il pool di connessioni gestito è abilitato o disabilitato.
gcloud
Utilizza il comando gcloud sql instances describe per visualizzare lo stato del pool di connessioni gestite per un'istanza:
gcloud sql instances describe INSTANCE_NAME \
--format="value(settings.connectionPoolConfig.connectionPoolingEnabled)"
Sostituisci quanto segue:
PROJECT_ID: il nome dell'istanza Cloud SQL.Se il pool di connessioni gestito è abilitato, viene restituita la seguente risposta:
connectionPoolingEnabled: true
REST v1
Per visualizzare lo stato del pool di connessioni gestite per la tua istanza Cloud SQL, utilizza il seguente comando e cerca connectionPoolingEnabled:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene l'istanza.
- INSTANCE_NAME: il nome dell'istanza Cloud SQL. Se per questa istanza è abilitato Private Service Connect, gli endpoint di Private Service Connect nelle reti VPC possono connettersi all'istanza.
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#instance",
"state": "RUNNABLE",
"databaseVersion": "POSTGRES_13",
"settings": {
"authorizedGaeApplications": [],
"tier": "db-custom-2-7680",
"kind": "sql#settings",
"availabilityType": "REGIONAL",
"pricingPlan": "PER_USE",
"replicationType": "SYNCHRONOUS",
"activationPolicy": "ALWAYS",
"ipConfiguration": {
"authorizedNetworks": [],
"pscConfig": {
"allowedConsumerProjects": [
"ALLOWED_PROJECTS"
],
"pscEnabled": true
},
"ipv4Enabled": false
},
...
"createTime": "2023-06-14T18:48:34.975Z",
"sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
"pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
"dnsName": "DNS_NAME"
}
REST v1beta4
Per visualizzare lo stato del pool di connessioni gestite per la tua istanza Cloud SQL, utilizza il seguente comando e cerca connectionPoolingEnabled:
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: l'ID o il numero di progetto del progetto Cloud de Confiance che contiene l'istanza.
- INSTANCE_NAME: il nome dell'istanza Cloud SQL. Se per questa istanza è abilitato Private Service Connect, gli endpoint di Private Service Connect nelle reti VPC possono connettersi all'istanza.
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{
"kind": "sql#instance",
"state": "RUNNABLE",
"databaseVersion": "POSTGRES_13",
"settings": {
"authorizedGaeApplications": [],
"tier": "db-custom-2-7680",
"kind": "sql#settings",
"availabilityType": "REGIONAL",
"pricingPlan": "PER_USE",
"replicationType": "SYNCHRONOUS",
"activationPolicy": "ALWAYS",
"ipConfiguration": {
"authorizedNetworks": [],
"pscConfig": {
"allowedConsumerProjects": [
"ALLOWED_PROJECTS"
],
"pscEnabled": true
},
"ipv4Enabled": false
},
...
"createTime": "2023-06-14T18:48:34.975Z",
"sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
"pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
"dnsName": "DNS_NAME"
}
Monitora il pool di connessioni gestito
Puoi monitorare l'esecuzione del pool di connessioni gestite sulle tue istanze Cloud SQL utilizzando le seguenti metriche del pool di connessioni gestite di Cloud SQL:
| Nome metrica | Descrizione |
|---|---|
| client_connections | Monitora il numero di connessioni in base allo stato della connessione client. Gli stati inclusi in questa metrica sono:
|
| client_connections_attempts_count | Il numero di tentativi di connessione client ricevuti per pool di connessioni. |
| client_connections_avg_wait_time | Il tempo medio trascorso da tutti i client in stato di attesa per un server. |
| client_connections_error_count | Il numero di errori per pool di connessioni che causano la disconnessione del client, inclusi errori di autenticazione, errori di configurazione della connessione client ed errori di connessione al server. |
| num_pools | Il numero totale di pool di connessioni per database. |
| server_connections | Monitora il conteggio delle connessioni al server in base allo stato della connessione al server. Gli stati inclusi in questa metrica sono:
|
Per saperne di più su queste metriche, consulta Metriche di Cloud SQL. Per visualizzare queste metriche utilizzando la console Cloud de Confiance , consulta Visualizza le metriche nella pagina Panoramica dell'istanza Cloud SQL.