Einige oder alle Informationen auf dieser Seite gelten möglicherweise nicht für Trusted Cloud von S3NS. Weitere Informationen finden Sie unter Unterschiede zu Google Cloud.

Diese Seite wurde von der Cloud Translation API übersetzt.

Verwaltetes Verbindungs-Pooling konfigurieren

MySQL | PostgreSQL | SQL Server

Auf dieser Seite wird beschrieben, wie Sie Managed Connection Pooling in Ihren Cloud SQL-Instanzen aktivieren, konfigurieren und überwachen.

Mit verwaltetem Verbindungs-Pooling können Sie Ihre Arbeitslasten skalieren, indem Sie die Ressourcennutzung und die Verbindungslatenz für Ihre Instanzen mithilfe von Pooling optimieren. Ausführliche Informationen zum Managed Connection Pooling und zur Verwendung für Ihre Instanzen finden Sie unter Übersicht zum Managed Connection Pooling.

Hinweise

Prüfen Sie, ob Ihre Instanz alle Anforderungen für die Verwendung von Managed Connection Pooling erfüllt.
Wenn Sie die gcloud CLI verwenden, prüfen Sie, ob die Version der gcloud CLI 515.0.0 oder höher ist.

Verwaltetes Verbindungs-Pooling aktivieren

Sie können den verwalteten Verbindungspool für eine Instanz bei der Erstellung aktivieren oder eine vorhandene Instanz bearbeiten, um ihn zu aktivieren.

Verwaltetes Verbindungs-Pooling für eine neue Instanz aktivieren

Informationen zum Erstellen einer neuen Instanz mit aktiviertem verwalteten Verbindungspooling finden Sie unter Instanzen erstellen. Sie können Managed Connection Pooling für eine neue Instanz nur mit der gcloud CLI oder der Cloud SQL API aktivieren.

Verwaltetes Verbindungspooling für eine vorhandene Instanz aktivieren

So aktivieren Sie den verwalteten Verbindungspool für eine vorhandene Instanz:

Console

Wechseln Sie in der Trusted Cloud Console zur Seite Cloud SQL-Instanzen.

Cloud SQL-Instanzen aufrufen
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 Eintrag Verbindungen.
Klicken Sie das Kästchen Verwalteten Verbindungspool aktivieren an, um den verwalteten Verbindungspool zu aktivieren.
Klicken Sie auf Speichern.

Hinweis: Dadurch wird Ihre Instanz neu gestartet.

gcloud

Verwenden Sie den Befehl gcloud sql instances, um das verwaltete Verbindungspooling zu aktivieren.

  gcloud sql instances patch INSTANCE_NAME \
  --enable-connection-pooling

Ersetzen Sie Folgendes:

INSTANCE_NAME: Der Name der Cloud SQL-Instanz.

REST Version 1

Verwenden Sie den folgenden Befehl und legen Sie connectionPoolingEnabled 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": {
      "connectionPoolingEnabled": true
    }
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Zum Prüfen des derzeit aktiven Kontos führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Zum Prüfen des derzeit aktiven Kontos führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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 und legen Sie connectionPoolingEnabled 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": {
      "connectionPoolingEnabled": true
    }
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

Terraform

Verwenden Sie die folgende Terraform-Ressource:

# This example shows creating an instance with Managed Connection Pooling enabled and custom flags set.
resource "google_sql_database_instance" "mysql_managed_connection_pooling_enable" {
  name                = "mysql-instance-managed-connection-pooling-enable"
  region              = "us-central1"
  database_version    = "MYSQL_8_0"
  deletion_protection = false

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    connection_pool_config {
      connection_pooling_enabled = true
    }
  }
}

Verwaltetes Verbindungs-Pooling für eine Instanz ändern

Nachdem Sie den verwalteten Verbindungspool aktiviert haben, können Sie ihn mit erweiterten Konfigurationsoptionen an die Anforderungen Ihrer Instanz anpassen. Diese Konfigurationsoptionen werden als Pool-Flags für das Managed Connection Pooling bezeichnet. Weitere Informationen zu den erweiterten Konfigurationsoptionen, ihren Standardwerten und Bereichen finden Sie unter Erweiterte Konfigurationsoptionen.

So ändern Sie die erweiterten Konfigurationsoptionen für das Managed Connection Pooling für eine Instanz:

Console

Wechseln Sie in der Trusted Cloud Console zur Seite Cloud SQL-Instanzen.

Cloud SQL-Instanzen aufrufen
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 Eintrag Verbindungen.
Maximieren Sie unter Verwalteter Verbindungspool die Erweiterten Pooling-Optionen.

Ändern Sie die erweiterten Pooling-Optionen, die Sie aktualisieren möchten.
Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud sql instances, um Konfigurationsoptionen zu ändern.

  gcloud sql instances patch INSTANCE_NAME \
  --connection-pool-flags=CONFIGURATION_NAME=CONFIGURATION_VALUE

Ersetzen Sie Folgendes:

INSTANCE_NAME: Der Name der Cloud SQL-Instanz.
CONFIGURATION_NAME: der Name der Konfigurationsoption. Eine Liste aller erweiterten Konfigurationsoptionen finden Sie unter Erweiterte Konfigurationsoptionen.
CONFIGURATION_VALUE: Der neue Wert für die ausgewählte Konfigurationsoption.

REST Version 1

Verwenden Sie den folgenden Befehl und legen Sie ConnectionPoolConfig fest, um die erweiterten Konfigurationen für das Managed Connection Pooling zu ändern:

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:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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 und legen Sie ConnectionPoolConfig fest, um die erweiterten Konfigurationen für das Managed Connection Pooling zu ändern:

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:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

Terraform

Wenn Sie die erweiterten Konfigurationen für Managed Connection Pooling ändern möchten, verwenden Sie die folgende Terraform-Ressource:

# This example shows modifying the flags of an existing Managed Connection Pooling configuration.
resource "google_sql_database_instance" "mysql_managed_connection_pooling_modify" {
  name                = "mysql-instance-managed-connection-pooling-modify"
  region              = "us-central1"
  database_version    = "MYSQL_8_0"
  deletion_protection = false

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    connection_pool_config {
      connection_pooling_enabled = true
      flags {
        name  = "max_pool_size" # Modify or add the name and value of an flag
        value = "10"
      }
    }
  }
}

Verwaltetes Verbindungs-Pooling für eine Instanz deaktivieren

Sie können Managed Connection Pooling für eine vorhandene Instanz über dieTrusted Cloud Console, die gcloud CLI oder die Cloud SQL API deaktivieren.

So deaktivieren Sie das Managed Connection Pooling für eine Instanz:

Console

Wechseln Sie in der Trusted Cloud Console zur Seite Cloud SQL-Instanzen.

Cloud SQL-Instanzen aufrufen
Suchen Sie die Instanz, für die Sie das verwaltete Verbindungspooling 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 Eintrag 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.

Hinweis: Dadurch wird Ihre Instanz neu gestartet.

gcloud

Verwenden Sie den Befehl gcloud sql instances, um den verwalteten Verbindungspool zu deaktivieren.

  gcloud sql instances patch INSTANCE_NAME \
  --no-enable-connection-pooling

Ersetzen Sie Folgendes:

PROJECT_ID: Der Name der Cloud SQL-Instanz.

REST Version 1

Verwenden Sie den folgenden Befehl, um das Managed Connection Pooling für eine Instanz zu deaktivieren, und legen Sie connectionPoolingEnabled 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": {
      "connectionPoolingEnabled": false
    }
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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 Managed Connection Pooling für eine Instanz zu deaktivieren, und legen Sie connectionPoolingEnabled 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": {
      "connectionPoolingEnabled": false
    }
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json und führen Sie den folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

Terraform

Verwenden Sie die folgende Terraform-Ressource, um Managed Connection Pooling für eine Instanz zu deaktivieren:

# This example shows disabling Managed Connection Pooling on an existing instance.
resource "google_sql_database_instance" "mysql_managed_connection_pooling_disable" {
  name                = "mysql-instance-managed-connection-pooling-disable"
  region              = "us-central1"
  database_version    = "MYSQL_8_0"
  deletion_protection = false

  settings {
    tier    = "db-perf-optimized-N-2"
    edition = "ENTERPRISE_PLUS"
    connection_pool_config {
      # Set to false to disable Managed Connection Pooling. You can also remove the block entirely.
      connection_pooling_enabled = false
    }
  }
}

Status des verwalteten Verbindungspools für eine Instanz ansehen

Sie können den Status von Managed Connection Pooling für eine Instanz in der Trusted Cloud Console, mit der gcloud CLI oder mit der Cloud SQL API aufrufen.

So rufen Sie den Status von Managed Connection Pooling für eine Cloud SQL Enterprise Plus-Instanz auf:

Console

Wechseln Sie in der Trusted Cloud Console zur Seite Cloud SQL-Instanzen.

Cloud SQL-Instanzen aufrufen
Suchen Sie die Instanz, für die Sie den Status des verwalteten Verbindungspools aufrufen 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

Verwenden Sie den Befehl gcloud sql instances describe, um den Status des verwalteten Verbindungspoolings für eine Instanz aufzurufen:

  gcloud sql instances describe INSTANCE_NAME
  --format="value(settings.connectionPoolConfig.connectionPoolingEnabled)"

Ersetzen Sie Folgendes:

PROJECT_ID: Der Name der Cloud SQL-Instanz.

Wenn das verwaltete Verbindungs-Pooling aktiviert ist, wird die folgende Antwort zurückgegeben:

connectionPoolingEnabled: true

REST Version 1

Verwenden Sie den folgenden Befehl, um den Status von Managed Connection Pooling für Ihre Cloud SQL-Instanz aufzurufen, und suchen Sie nach connectionPoolingEnabled:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die ID oder Projektnummer des Trusted 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:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0",
  "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

Verwenden Sie den folgenden Befehl, um den Status von Managed Connection Pooling für Ihre Cloud SQL-Instanz aufzurufen, und suchen Sie nach connectionPoolingEnabled:

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

PROJECT_ID: die ID oder Projektnummer des Trusted 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:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Sie sollten eine JSON-Antwort ähnlich wie diese erhalten:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0",
  "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 beobachten, wie Managed Connection Pooling auf Ihren Cloud SQL-Instanzen ausgeführt wird. Verwenden Sie dazu die folgenden Messwerte für Cloud SQL Managed Connection Pooling:

Messwertname	Beschreibung
Threads	Erfasst die Anzahl der Threads im Verbindungspool nach Status. Die in diesem Messwert enthaltenen Status sind: `idle`: Die Anzahl der inaktiven Threads im Pool. `active`: Die Anzahl der aktiven (nicht im Leerlauf befindlichen) Threads im Pool.
pending_connection	Die Anzahl der Verbindungen, die sich aktiv in der Pooling-Warteschlange befinden.
avg_wait_time	Die durchschnittliche Zeit, die die Verbindungsanfrage auf einen Server wartet.

Weitere Informationen zu diesen Messwerten finden Sie unter Cloud SQL-Messwerte. Informationen zum Aufrufen dieser Messwerte über die Trusted Cloud Console finden Sie unter Messwerte auf der Cloud SQL-Instanzübersichtsseite ansehen.

Verwaltetes Verbindungs-Pooling konfigurieren

Hinweise

Verwaltetes Verbindungs-Pooling aktivieren

Verwaltetes Verbindungs-Pooling für eine neue Instanz aktivieren

Verwaltetes Verbindungspooling für eine vorhandene Instanz aktivieren

Console

gcloud

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Terraform

Verwaltetes Verbindungs-Pooling für eine Instanz ändern

Console

gcloud

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Terraform

Verwaltetes Verbindungs-Pooling für eine Instanz deaktivieren

Console

gcloud

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Terraform

Status des verwalteten Verbindungspools für eine Instanz ansehen

Console

gcloud

REST Version 1

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS oder Cloud Shell)

PowerShell (Windows)

Verwaltetes Verbindungs-Pooling überwachen

Nächste Schritte