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 Verbindungs-Latenz für Ihre Instanzen mithilfe von Pooling optimieren. Ausführliche Informationen zum verwalteten Verbindungs-Pooling und zur Verwendung für Ihre Instanzen finden Sie unter Übersicht zum verwalteten Verbindungs-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 das verwaltete Verbindungs-Pooling für eine Instanz bei der Erstellung aktivieren oder eine vorhandene Instanz bearbeiten, um es zu aktivieren.

Verwaltetes Verbindungs-Pooling für eine neue Instanz aktivieren

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

Verwaltetes Verbindungs-Pooling für eine vorhandene Instanz aktivieren

So aktivieren Sie das verwaltete Verbindungs-Pooling für eine vorhandene Instanz:

Console

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

Cloud SQL-Instanzen aufrufen
Suchen Sie nach der Instanz, für die Sie das verwaltete Verbindungs-Pooling aktivieren möchten. Klicken Sie auf den Instanznamen, um die Übersichtsseite der Instanz zu öffnen.
Klicken Sie auf Bearbeiten.
Maximieren Sie unter Instanz anpassen die Option Verbindungen.
Wenn Sie das verwaltete Verbindungs-Pooling aktivieren möchten, setzen Sie ein Häkchen bei Verwalteten Verbindungspool aktivieren.
Klicken Sie auf Speichern.

Hinweis :Dadurch wird Ihre Instanz neu gestartet.

gcloud

Verwenden Sie den Befehl gcloud sql instances, um das verwaltete Verbindungs-Pooling 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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt haben, die Sie automatisch in der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, 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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, 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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, 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/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 das verwaltete Verbindungs-Pooling aktiviert haben, können Sie es mithilfe der erweiterten Konfigurationsoptionen an die Anforderungen Ihrer Instanz anpassen. Diese Konfigurationsoptionen werden als Pool-Flags für verwaltetes Verbindungs-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 verwaltete Verbindungs-Pooling für eine Instanz:

Console

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

Cloud SQL-Instanzen aufrufen
Suchen Sie nach der Instanz, für die Sie das verwaltete Verbindungs-Pooling aktivieren möchten. Klicken Sie auf den Instanznamen, um die Übersichtsseite der Instanz zu öffnen.
Klicken Sie auf Bearbeiten.
Maximieren Sie unter Instanz anpassen die Option 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 verwaltete Verbindungs-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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, 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 ConnectionPoolConfig fest, um die erweiterten Konfigurationen für das verwaltete Verbindungs-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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, 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/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 die erweiterten Konfigurationen für das verwaltete Verbindungs-Pooling zu ändern:

# 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 das verwaltete Verbindungs-Pooling für eine vorhandene Instanz über dieGoogle Cloud Console, die gcloud CLI oder die 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.

Cloud SQL-Instanzen aufrufen
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 die Option Verbindungen.
Wenn Sie das verwaltete Verbindungs-Pooling deaktivieren möchten, entfernen Sie das Häkchen bei Verwalteten Verbindungspool aktivieren.
Klicken Sie auf Speichern.

Hinweis :Dadurch wird Ihre Instanz neu gestartet.

gcloud

Verwenden Sie den Befehl gcloud sql instances, um das verwaltete Verbindungs-Pooling 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 und legen Sie connectionPoolingEnabled fest, um das verwaltete Verbindungs-Pooling für eine Instanz zu deaktivieren:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, 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, um das verwaltete Verbindungs-Pooling für eine Instanz zu deaktivieren:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. Um herauszufinden, welches Konto gerade aktiv ist, 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/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 das verwaltete Verbindungs-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 Verbindungs-Poolings für eine Instanz ansehen

Sie können den Status des verwalteten Verbindungs-Poolings für eine Instanz über die Google Cloud Console, die gcloud CLI oder die Cloud SQL API aufrufen.

So rufen Sie den Status des verwalteten Verbindungs-Poolings für eine Cloud SQL Enterprise Plus-Instanz auf:

Console

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

Cloud SQL-Instanzen aufrufen
Suchen Sie nach der Instanz, für die Sie den Status des verwalteten Verbindungs-Poolings aufrufen möchten. Klicken Sie auf den Instanznamen, um die Übersichtsseite der Instanz zu öffnen.

Im Abschnitt Verbindungen sehen Sie, ob das verwaltete Verbindungs-Pooling aktiviert oder deaktiviert ist.

gcloud

Verwenden Sie den Befehl gcloud sql instances describe, um den Status des verwalteten Verbindungs-Poolings 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 des verwalteten Verbindungs-Poolings 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 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:

curl (Linux, macOS oder Cloud Shell)

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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. 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 des verwalteten Verbindungs-Poolings 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 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:

curl (Linux, macOS oder Cloud Shell)

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 in der gcloud-Befehlszeile angemeldet haben, indem Sie gcloud init oder gcloud auth login ausgeführt haben. 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 Google Cloud Console finden Sie unter Messwerte auf der Cloud SQL-Instanzübersichtsseite ansehen.

Verwaltetes Verbindungs-Pooling konfigurieren Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweise

Verwaltetes Verbindungs-Pooling aktivieren

Verwaltetes Verbindungs-Pooling für eine neue Instanz aktivieren

Verwaltetes Verbindungs-Pooling 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 Verbindungs-Poolings 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

Verwaltetes Verbindungs-Pooling konfigurieren