Verwaltetes Verbindungs-Pooling konfigurieren

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Auf dieser Seite wird beschrieben, wie Sie das verwaltete Verbindungspooling in AlloyDB for PostgreSQL aktivieren, eine Verbindung herstellen und überwachen. Das Verwaltete Verbindungs-Pooling ist ein Designmuster, das die Verwaltung von Datenbankverbindungen durch die Pflege eines Pools von vorab hergestellten Verbindungen optimiert. Dieser Pool von Verbindungen wird dann von der Anwendung wiederverwendet, anstatt Verbindungen für jeden Datenbankvorgang zu öffnen und zu schließen. Dadurch werden Leistung und Ressourcennutzung verbessert.

Mit dem verwalteten Verbindungs-Pooling können Sie Ihre Datenbanklasten skalieren, indem Sie die Ressourcennutzung und die Verbindungslatenz für Ihre AlloyDB-Instanzen optimieren. Beim verwalteten Verbindungs-Pooling werden eingehende Anfragen nach Möglichkeit mithilfe von Pooling und Multiplexing dynamisch Serververbindungen zugewiesen. Dieser Ansatz führt zu Leistungsverbesserungen, insbesondere bei skalierten Verbindungen, da plötzliche Verbindungsspitzen abgefangen und vorhandene Datenbankverbindungen wiederverwendet werden. Anstatt eine Verbindung zu einer bestimmten Datenbank herzustellen, verbindet sich eine Anwendung bei Verwendung des verwalteten Verbindungs-Poolings mit einem Pooler. Dies führt zu kürzeren Verbindungszeiten und Skalierbarkeit für Ihre Leselasten.

Sie können das verwaltete Verbindungs-Pooling für jede Transaktionslast verwenden. Es eignet sich jedoch am besten für Anwendungen mit mehr kurzlebigen Verbindungen oder Anwendungen, bei denen es zu einem Verbindungsanstieg kommen kann.

Hinweise

Sie müssen eine direkte Verbindung zu Ihrer Instanz herstellen. Das verwaltete Verbindungs-Pooling unterstützt keine Verbindung mit dem AlloyDB Auth-Proxy oder AlloyDB Language Connectors.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Cloud AlloyDB Admin (roles/alloydb.admin) für die AlloyDB-Instanz zuzuweisen, um die Berechtigung zum Aktivieren und Verwenden des verwalteten Verbindungspools zu erhalten. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigung alloydb.instances.update, die zum Aktivieren und Verwenden des verwalteten Verbindungspools erforderlich ist.

Sie können diese Berechtigung auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Erweiterte Konfigurationsoptionen

Der verwaltete AlloyDB-Verbindungspool unterstützt die folgenden erweiterten Konfigurationsoptionen für das Pooling. Mit diesen Konfigurationsoptionen können Sie das verwaltete Verbindungs-Pooling an die Anforderungen Ihrer Instanz anpassen. Sie können diese Konfigurationen auf Instanzebene über die Google Cloud Console, die gcloud CLI oder die AlloyDB API festlegen.

Standardmäßig werden über das verwaltete Verbindungspoolen Verbindungen zum AlloyDB-Server initiiert. Wenn eine Clientverbindung hergestellt und authentifiziert wird, werden beim verwalteten Verbindungs-Pooling möglicherweise eine oder mehrere Serververbindungen erstellt, damit die Größe des Pools der ausgewählten Konfiguration entspricht. Der Clientverbindung wird dann eine verfügbare Serververbindung zugewiesen. Serververbindungen werden aufrechterhalten, bis sie explizit geschlossen werden oder länger als die Zeitüberschreitung für inaktive Serververbindungen inaktiv sind.

Verwaltetes Verbindungs-Pooling aktivieren

Sie können das verwaltete Verbindungs-Pooling für alle vorhandenen oder neuen Instanzen aktivieren.

Für eine neue primäre Instanz aktivieren

Informationen zum Erstellen einer neuen primären Instanz mit aktiviertem verwaltetem Verbindungs-Pooling finden Sie unter Primäre Instanz erstellen. Sie können das verwaltete Verbindungs-Pooling für eine Instanz über die Google Cloud Console, die Google Cloud CLI oder die AlloyDB API aktivieren.

Für eine neue Lesepoolinstanz aktivieren

Eine neue Lesepoolinstanz mit aktiviertem verwalteten Verbindungs-Pooling erstellen Sie unter Lesepoolinstanz erstellen. Sie können das verwaltete Verbindungs-Pooling für eine Instanz über die Google Cloud Console, die Google Cloud CLI oder die AlloyDB API aktivieren.

Für eine vorhandene Instanz aktivieren

Sie können das verwaltete Verbindungs-Pooling für eine vorhandene Instanz mit der Google Cloud Console, der Google Cloud CLI oder der AlloyDB API aktivieren.

gcloud alpha alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --enable-connection-pooling

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

{
  "connectionPoolConfig": {
    "enabled": true
  }
}

Verbindung zum verwalteten Verbindungs-Pooling herstellen

Die Verbindung mit einem verwalteten Verbindungspool entspricht einer direkten Datenbankverbindung, mit Ausnahme des Ports. Das verwaltete Verbindungs-Pooling überwacht Port 6432. Jeder Nutzer, der der AlloyDB-Instanz hinzugefügt wurde, kann eine Verbindung über das verwaltete Verbindungspool verwenden.

Über die integrierte Authentifizierung eine Verbindung herstellen

Im Befehlsbeispiel wird Ihre AlloyDB-Instanz über die integrierte Authentifizierung mit dem verwalteten Verbindungspool verbunden.

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

Verbindung über SSL-Verbindungen herstellen

Der SSL-Modus der Instanz gilt auch für alle Verbindungen zum verwalteten Verbindungspool. Standardmäßig werden nur SSL-Verbindungen akzeptiert. Wenn Sie unverschlüsselte Verbindungen zulassen möchten, verwenden Sie den folgenden Befehl gcloud alloydb instances update, um den SSL-Modus der Instanz auf ALLOW_UNENCRYPTED_AND_ENCRYPTED festzulegen.

gcloud alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --ssl-mode=ALLOW_UNENCRYPTED_AND_ENCRYPTED

Verwaltetes Verbindungs-Pooling für eine Instanz ändern

Nachdem Sie das verwaltete Verbindungspooling aktiviert haben, können Sie die Optionen für das verwaltete Verbindungspooling mithilfe der erweiterten Konfigurationsoptionen an die Anforderungen Ihrer Instanz anpassen. Diese Konfigurationsoptionen werden als Flags für das verwaltete Verbindungs-Pooling bezeichnet. Weitere Informationen zu den Konfigurationsoptionen, ihren Standardwerten und ihren Bereichen finden Sie unter Erweiterte Konfigurationsoptionen.

Sie können die Konfigurationsoptionen für das verwaltete Verbindungspooling für eine vorhandene Instanz über die Google Cloud Console, die Google Cloud CLI oder die AlloyDB API ändern.

  gcloud alpha alloydb instances update INSTANCE_ID \
    --project=PROJECT_ID \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    { \
      --connection-pooling-pool-mode=CONNECTION_MODE \
      | --connection-pooling-max-pool-size=MAX_POOL_SIZE \
      | --connection-pooling-min-pool-size=MIN_POOL_SIZE \
      | --connection-pooling-max-client-connections=MAX_CLIENT_CONNECTION \
      | --connection-pooling-server-idle-timeout=SERVER_IDLE_TIMEOUT_PERIOD \
      | --connection-pooling-query-wait-timeout=QUERY_WAIT_TIMEOUT_PERIOD \
      | --connection-pooling-ignore-startup-parameters=IGNORE_STARTUP_PARAMETERS \
    }

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

{
  "connectionPoolConfig": {
    "enabled": true,
    "flags": {
      "pool_mode": "POOL_MODE",
      "max_pool_size": "MAX_POOL_SIZE",
      "min_pool_size": "MIN_POOL_SIZE",
      "max_client_connection": "MAX_CLIENT_CONNECTION",
      "server_idle_timeout": "SERVER_IDLE_TIMEOUT",
      "query_wait_timeout": "QUERY_WAIT_TIMEOUT",
      "ignore_startup_parameters": "IGNORE_STARTUP_PARAMETERS"
    },
  }
}

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 Google Cloud CLI oder der AlloyDB API aufrufen.

gcloud alpha alloydb instances describe INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --format="value(connectionPoolConfig.enabled)"

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

Verwaltetes Verbindungs-Pooling für eine vorhandene Instanz deaktivieren

Sie können das verwaltete Verbindungs-Pooling für eine vorhandene Instanz über die Google Cloud Console, die Google Cloud CLI oder die AlloyDB API deaktivieren.

gcloud alpha alloydb instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --region=REGION_ID \
  --cluster=CLUSTER_ID \
  --no-enable-connection-pooling

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID

{
  "connectionPoolConfig": {
    "enabled": false
  }
}

Verwaltetes Verbindungs-Pooling überwachen

AlloyDB bietet die folgenden Messwerte, mit denen Sie die Ausführung des verwalteten Verbindungs-Poolings auf Ihrer Instanz im Blick behalten können. Sie können diese Messwerte im Metrics Explorer aufrufen.

Weitere Informationen finden Sie unter AlloyDB-Messwerte.

Beschränkungen

Die folgenden Einschränkungen gelten während der Vorabversion und können nach der Veröffentlichung der GA-Version geändert oder entfernt werden:

• Das verwaltete Verbindungs-Pooling unterstützt keine Verbindung mit dem AlloyDB Auth-Proxy oder AlloyDB-Sprach-Connectors.
• Wenn Sie das verwaltete Verbindungspooling im Transaktions-Pooling-Modus verwenden, werden die folgenden SQL-Funktionen nicht unterstützt:
  • SET/RESET
  • LISTEN
  • WITH HOLD CURSOR
  • PREPARE/DEALLOCATE
  • PRESERVE/DELETE ROW Temporäre Tabellen
  • LOAD
  • Warnende Sperren auf Sitzungsebene
  • Auf Protokollebene erstellte Pläne