Verwaltetes Verbindungs-Pooling konfigurieren

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

Mit verwaltetem Verbindungspooling können Sie Ihre Datenbankarbeitslasten skalieren, indem Sie die Ressourcennutzung und die Verbindungs-Latenz für Ihre AlloyDB-Instanzen optimieren. Beim verwalteten Verbindungs-Pooling werden Serververbindungen nach Möglichkeit dynamisch eingehenden Anfragen zugewiesen. Dazu werden Pooling und Multiplexing verwendet. Dieser Ansatz führt zu Leistungsverbesserungen, insbesondere bei skalierten Verbindungen, da plötzliche Verbindungsspitzen abgefangen und vorhandene Datenbankverbindungen wiederverwendet werden. Wenn Sie verwaltetes Verbindungs-Pooling verwenden, stellt eine Anwendung keine Verbindung zu einer bestimmten Datenbank her, sondern zu einem Pooler. Das führt zu kürzeren Verbindungszeiten und Skalierbarkeit für Ihre Leseworkloads.

Sie können verwaltetes Verbindungs-Pooling für jede transaktionale Arbeitslast verwenden. Es eignet sich jedoch am besten für Anwendungen mit vielen kurzlebigen Verbindungen oder Anwendungen, bei denen es zu einem plötzlichen Anstieg der Verbindungen kommen kann.

Hinweise

Sie müssen über eine direkte Verbindung eine Verbindung zu Ihrer Instanz herstellen. Das verwaltete Verbindungs-Pooling unterstützt keine Verbindung mit dem AlloyDB Auth-Proxy oder den AlloyDB-Sprach-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 zu erhalten, die Sie zum Aktivieren und Verwenden von verwaltetem Verbindungspooling benötigen. 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 von verwaltetem Verbindungspooling erforderlich ist.

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

Erweiterte Konfigurationsoptionen

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

Standardmäßig werden durch verwaltetes Connection Pooling Verbindungen zum AlloyDB-Server initiiert. Wenn eine Clientverbindung hergestellt und authentifiziert wird, können durch verwaltetes Verbindungspooling eine oder mehrere Serververbindungen erstellt werden, 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 der Zeitraum für die Zeitüberschreitung bei inaktiven Serververbindungen inaktiv sind.

Verwaltetes Verbindungs-Pooling aktivieren

Sie können den verwalteten Verbindungspool 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 verwalteten Verbindungs-Pooling finden Sie unter Primäre Instanz erstellen. Sie können das verwaltete Verbindungspooling für eine Instanz über dieGoogle Cloud -Konsole, die Google Cloud CLI oder die AlloyDB API aktivieren.

Für eine neue Lesepoolinstanz aktivieren

Informationen zum Erstellen einer neuen Lesepoolinstanz mit aktiviertem verwalteten Verbindungs-Pooling finden Sie unter Lesepoolinstanz erstellen. Sie können das verwaltete Verbindungspooling für eine Instanz über dieGoogle Cloud -Konsole, die Google Cloud CLI oder die AlloyDB API aktivieren.

Für eine vorhandene Instanz aktivieren

Sie können das verwaltete Verbindungspooling für eine vorhandene Instanz über dieGoogle Cloud -Konsole, die Google Cloud CLI oder die 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

Das Herstellen einer Verbindung zu verwaltetem Verbindungs-Pooling ist mit direkten Datenbankverbindungen identisch, nur dass ein anderer Port verwendet wird. Das verwaltete Verbindungs-Pooling überwacht Port 6432. Jeder Nutzer, der der AlloyDB-Instanz hinzugefügt wird, kann eine Verbindung über das verwaltete Connection Pooling herstellen.

Mit integrierter Authentifizierung verbinden

Im Beispielbefehl wird Ihre AlloyDB-Instanz über die integrierte Authentifizierung mit dem verwalteten Verbindungspooling 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 gcloud alloydb instances update-Befehl, 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 verwaltetes Connection Pooling bezeichnet. Weitere Informationen zu den Konfigurationsoptionen, ihren Standardwerten und 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 \
      | --connection-pooling-server-lifetime=SERVER_LIFETIME \
      | --connection-pooling-client-connection-idle-timeout=CLIENT_CONNECTION_IDLE_TIMEOUT \
    }

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 Verbindungspoolings für eine Instanz ansehen

Sie können den Status des verwalteten Verbindungspoolings für eine Instanz über die Google Cloud Console, die Google Cloud CLI oder die 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 Verbindungspooling für eine vorhandene Instanz deaktivieren

Sie können das verwaltete Verbindungspooling für eine vorhandene Instanz über dieGoogle Cloud -Konsole, 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 überwachen können, wie das verwaltete Verbindungs-Pooling auf Ihrer Instanz ausgeführt wird. Sie können diese Messwerte mit dem Metrics Explorer ansehen.

Weitere Informationen finden Sie unter AlloyDB-Messwerte.

Beschränkungen

Die folgenden Einschränkungen gelten während der Vorschau und können sich mit der GA-Version oder danach ändern oder entfernt werden:

• Das verwaltete Verbindungs-Pooling unterstützt keine Verbindungen mit dem AlloyDB-Auth-Proxy oder AlloyDB-Sprach-Connectors.
• Wenn Sie verwaltetes Connection Pooling 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
  • Sperren auf Sitzungsebene
  • Auf Protokollebene vorbereitete Pläne
• Verwaltetes Verbindungs-Pooling wird für öffentliche IP-Verbindungen nicht unterstützt.