Auf dieser Seite wird beschrieben, wie Sie das verwaltete Verbindungs-Pooling für Ihre Cloud SQL-Instanzen konfigurieren.
Hinweise
- Prüfen Sie, ob Ihre Instanz alle Anforderungen für die Verwendung des verwalteten Verbindungspools erfüllt.
- Wenn Sie die gcloud CLI verwenden, verwenden Sie den Befehl
gcloud beta
und prüfen Sie, ob Ihre gcloud CLI-Version515.0.0
oder höher ist. - Prüfen Sie, ob für Ihre Instanz die neue Cloud SQL-Netzwerkarchitektur verwendet wird. Wenn für Ihre Instanz noch die alte Netzwerkarchitektur verwendet wird, führen Sie ein Upgrade auf die neue Netzwerkarchitektur aus.
Sie können das verwaltete Verbindungs-Pooling für eine Instanz beim Erstellen aktivieren oder eine vorhandene Instanz bearbeiten, um es zu aktivieren.
Verwaltetes Verbindungs-Pooling für eine neue Instanz aktivieren
Informationen zum Erstellen einer Instanz mit aktiviertem verwalteten Verbindungs-Pooling finden Sie unter Instanzen erstellen. Sie können das verwaltete Verbindungs-Pooling für eine Instanz mit der gcloud CLI oder der Cloud SQL API aktivieren.
Verwaltetes Verbindungs-Pooling für eine vorhandene Instanz aktivieren
Sie können das verwaltete Verbindungs-Pooling für eine vorhandene Instanz mit der Google Cloud Console, der gcloud CLI oder der Cloud SQL API aktivieren. Sie müssen den verwalteten Verbindungspool aktivieren, bevor Sie die Optionen für den verwalteten Verbindungspool ändern können.
Console
Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.
Suchen Sie die Instanz, für die Sie den verwalteten Verbindungspool aktivieren möchten. Klicken Sie auf den Instanznamen, um die Übersichtsseite der Instanz zu öffnen.
Klicken Sie auf Bearbeiten.
Maximieren Sie unter Instanz anpassen den Bereich Verbindungen.
Wenn Sie das verwaltete Verbindungs-Pooling aktivieren möchten, setzen Sie ein Häkchen in das Kästchen Verwalteten Verbindungspool aktivieren.
Klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud beta sql instances
, um das verwaltete Verbindungs-Pooling zu aktivieren.
gcloud beta sql instances patch INSTANCE_NAME \
--enable-connection-pooling
Ersetzen Sie Folgendes:
INSTANCE_NAME
: Der Name der Cloud SQL-Instanz, für die Sie das verwaltete Verbindungspoolen aktivieren möchten.
REST Version 1
Verwenden Sie den folgenden Befehl, um das verwaltete Verbindungs-Pooling für eine vorhandene Instanz zu aktivieren und connectionPoolingEnabled
festzulegen:
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Projekt-ID
- INSTANCE_ID: die Instanz-ID
HTTP-Methode und URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
JSON-Text anfordern:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": true } } }
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "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
Verwenden Sie den folgenden Befehl, um das verwaltete Verbindungs-Pooling für eine vorhandene Instanz zu aktivieren und connectionPoolingEnabled
festzulegen:
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Projekt-ID
- INSTANCE_ID: die Instanz-ID
HTTP-Methode und URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
JSON-Text anfordern:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": true } } }
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ "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" }
Verwalteten Verbindungspool für eine Instanz ändern
Nachdem Sie den verwalteten Verbindungspool aktiviert haben, können Sie ihn mithilfe der verfügbaren Konfigurationsoptionen anpassen. Diese Konfigurationsoptionen werden als Managed Connection Pooling-Pool-Flags bezeichnet. Konfigurationen, die dem verwalteten Verbindungspool hinzugefügt werden, werden auf alle von der Instanz verwendeten Pools angewendet. Weitere Informationen zu den verfügbaren Konfigurationsoptionen, ihren Standardwerten und ihren Bereichen finden Sie unter Verfügbare Konfigurationsoptionen.
So ändern Sie die verfügbaren Konfigurationsoptionen für den verwalteten Verbindungspool für eine Instanz:
Console
Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.
Suchen Sie die Instanz, für die Sie den verwalteten Verbindungspool aktivieren möchten. Klicken Sie auf den Instanznamen, um die Übersichtsseite der Instanz zu öffnen.
Klicken Sie auf Bearbeiten.
Maximieren Sie unter Instanz anpassen den Bereich Verbindungen.
Maximieren Sie unter Verwalteter Verbindungspool die Option Erweiterte Pooling-Optionen.
Ändern Sie die verfügbaren Pooling-Optionen, die Sie aktualisieren möchten.
Klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud beta sql instances
, um Konfigurationsoptionen zu ändern.
gcloud beta sql instances patch INSTANCE_NAME \
--connection-pool-flags=CONFIGURATION_NAME=CONFIGURATION_VALUE
Ersetzen Sie Folgendes:
INSTANCE_NAME
: Der Name der Cloud SQL-Instanz, für die Sie das verwaltete Verbindungspoolen ändern möchten.CONFIGURATION_NAME
: der Name der Konfigurationsoption, die Sie ändern möchten. Eine Liste aller verfügbaren Konfigurationsoptionen finden Sie unter Verfügbare Konfigurationsoptionen.CONFIGURATION_VALUE
: Der neue Wert für die ausgewählte Konfigurationsoption.
REST Version 1
Wenn Sie die verfügbaren Konfigurationen für das verwaltete Verbindungspoolen ändern möchten, verwenden Sie den folgenden Befehl und legen Sie ConnectionPoolConfig
fest:
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Projekt-ID
- INSTANCE_ID: die Instanz-ID
HTTP-Methode und URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
JSON-Text anfordern:
{ "settings": { "connectionPoolConfig": { "flags": [ { "name": "CONFIGURATION_NAME", "value":"CONFIGURATION_VALUE" } ] } } }
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "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
Wenn Sie die verfügbaren Konfigurationen für das verwaltete Verbindungspoolen ändern möchten, verwenden Sie den folgenden Befehl und legen Sie ConnectionPoolConfig
fest:
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Projekt-ID
- INSTANCE_ID: die Instanz-ID
HTTP-Methode und URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
JSON-Text anfordern:
{ "settings": { "connectionPoolConfig": { "flags": [ { "name": "CONFIGURATION_NAME", "value":"CONFIGURATION_VALUE" } ] } } }
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ "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" }
Verwaltetes Verbindungs-Pooling für eine Instanz deaktivieren
Sie können das verwaltete Verbindungs-Pooling für eine vorhandene Instanz mit der Google Cloud Console, der gcloud CLI oder der Cloud SQL API deaktivieren.
So deaktivieren Sie das verwaltete Verbindungs-Pooling für eine Instanz:
Console
Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.
Suchen Sie die Instanz, für die Sie das verwaltete Verbindungs-Pooling deaktivieren möchten. Klicken Sie auf den Instanznamen, um die Übersichtsseite der Instanz zu öffnen.
Klicken Sie auf Bearbeiten.
Maximieren Sie unter Instanz anpassen den Bereich Verbindungen.
Wenn Sie das verwaltete Verbindungs-Pooling deaktivieren möchten, entfernen Sie das Häkchen aus dem Kästchen Verwalteten Verbindungspool aktivieren.
Klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud beta sql instances
, um das verwaltete Verbindungs-Pooling zu deaktivieren.
gcloud beta sql instances patch INSTANCE_NAME \
--no-enable-connection-pooling
Ersetzen Sie Folgendes:
PROJECT_ID
: Der Name der Cloud SQL-Instanz, für die Sie das verwaltete Verbindungspoolen deaktivieren möchten.
REST Version 1
Verwenden Sie den folgenden Befehl, um das verwaltete Verbindungs-Pooling für eine Instanz zu deaktivieren und connectionPoolingEnabled
festzulegen:
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Projekt-ID
- INSTANCE_ID: die Instanz-ID
HTTP-Methode und URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
JSON-Text anfordern:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": false } } }
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "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
Verwenden Sie den folgenden Befehl, um das verwaltete Verbindungs-Pooling für eine Instanz zu deaktivieren und connectionPoolingEnabled
festzulegen:
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die Projekt-ID
- INSTANCE_ID: die Instanz-ID
HTTP-Methode und URL:
PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
JSON-Text anfordern:
{ "settings": { "connectionPoolConfig": { "connectionPoolingEnabled": false } } }
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ "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" }
Status des verwalteten Verbindungs-Poolings für eine Instanz aufrufen
Sie können den Status des verwalteten Verbindungspools für eine Instanz mit der Google Cloud Console, der gcloud CLI oder der Cloud SQL API aufrufen.
So rufen Sie den Status des verwalteten Verbindungspools für eine Cloud SQL Enterprise Plus-Instanz auf:
Console
Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.
Suchen Sie die Instanz, für die Sie das verwaltete Verbindungs-Pooling deaktivieren möchten. Klicken Sie auf den Instanznamen, um die Übersichtsseite der Instanz zu öffnen.
Im Abschnitt Verbindungen wird angezeigt, ob der verwaltete Verbindungspool aktiviert oder deaktiviert ist.
gcloud
gcloud beta sql instances describe INSTANCE_NAME| 2 connectionPoolingEnabled
Ersetzen Sie Folgendes:
PROJECT_ID
: Der Name der Cloud SQL-Instanz, für die Sie den Status des verwalteten Verbindungspools aufrufen möchten.Wenn der verwaltete Verbindungspool aktiviert ist, wird die folgende Antwort zurückgegeben:
connectionPoolingEnabled: true
REST Version 1
Wenn Sie den Status des verwalteten Verbindungspools für Ihre Cloud SQL-Instanz aufrufen möchten, verwenden Sie den folgenden Befehl und suchen Sie nach ConnectPoolingEnabled
:
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält.
- INSTANCE_NAME: Der Name der Cloud SQL-Instanz. Wenn für diese Instanz Private Service Connect aktiviert ist, können Private Service Connect-Endpunkte in VPC-Netzwerken eine Verbindung zu ihr herstellen.
HTTP-Methode und URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten in etwa folgende JSON-Antwort erhalten:
{ "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
Wenn Sie den Status des verwalteten Verbindungspools für Ihre Cloud SQL-Instanz aufrufen möchten, verwenden Sie den folgenden Befehl und suchen Sie nach ConnectPoolingEnabled
:
Ersetzen Sie diese Werte in den folgenden Anfragedaten:
- PROJECT_ID: die ID oder Projektnummer des Google Cloud-Projekts, das die Instanz enthält.
- INSTANCE_NAME: Der Name der Cloud SQL-Instanz. Wenn für diese Instanz Private Service Connect aktiviert ist, können Private Service Connect-Endpunkte in VPC-Netzwerken eine Verbindung zu ihr herstellen.
HTTP-Methode und URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:
Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:
{ "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" }
Verwaltetes Verbindungs-Pooling überwachen
Sie können die Ausführung des verwalteten Verbindungspools in Ihren Cloud SQL-Instanzen mithilfe der folgenden Cloud SQL-Messwerte für das verwaltete Verbindungspool-Konzept überwachen:
Messwertname | Beschreibung |
---|---|
num_pools | Die Gesamtzahl der Verbindungspools pro Datenbank. |
client_connection | Erfasst die Anzahl der Verbindungen nach dem Status der Clientverbindung. Zu den Status, die in diesem Messwert enthalten sind, gehören:
|
server_connections | Erfasst die Anzahl der Serververbindungen anhand des Status der Serververbindung. Zu den Status, die in diesem Messwert enthalten sind, gehören:
|
client_connections_avg_wait_time | Die durchschnittliche Zeit, die alle Clients im Wartestatus für einen Server verbringen. |
Weitere Informationen zu diesen Messwerten finden Sie unter Cloud SQL-Messwerte. Informationen zum Aufrufen dieser Messwerte in der Google Cloud Console finden Sie unter Messwerte auf der Cloud SQL-Instanzübersichtsseite ansehen.