Verbindung zu Cloud SQL herstellen

Auf dieser Seite erhalten Sie einen Überblick über die Möglichkeiten, eine Verbindung zu Ihrer Cloud SQL-Instanz herzustellen.

Bevor Sie eine Verbindung zu einer Cloud SQL-Instanz herstellen können, müssen Sie entscheiden, wie Sie Ihre Cloud SQL-Instanz und die unterstützenden Netzwerkressourcen bereitstellen und konfigurieren möchten. Wenn Ihre Cloud SQL-Instanz bereits konfiguriert und bereitgestellt ist, können Sie auf dieser Seite die verschiedenen Möglichkeiten kennenlernen, Ihre Clients mit der vorhandenen Instanz zu verbinden.

IP-Adresstyp: privat oder öffentlich

Wenn Sie Ihre Cloud SQL-Instanz zum ersten Mal erstellen, können Sie wählen, ob Sie die Instanz mit einer öffentlichen IP-Adresse, einer privaten IP-Adresse oder einer Kombination aus beiden konfigurieren möchten.

Sie wählen die IP-Adresskonfiguration Ihrer Instanz basierend auf den Anforderungen Ihrer Anwendung aus. Nachdem Sie Ihre Instanz konfiguriert haben, geben Sie entweder eine öffentliche IP-Adresse, eine private IP-Adresse oder in einigen Fällen einen DNS-Namen in Ihrer Clientverbindungsstring an.

Private IP-Adresse Öffentliche IP-Adresse
Beschreibung Interne, nur über VPC-Netzwerk (Virtual Private Cloud) verfügbare (private) IP-Adresse Eine externe, über das Internet zugängliche (öffentliche) IP-Adresse
Entscheidungspunkte

Müssen Sie eine Verbindung von Clients herstellen, die in VPC-Netzwerken gehostet werden, oder von Clients, die Zugriff auf diese VPC-Netzwerke haben? Google Cloud

Wenn ja, wählen Sie eine private IP-Adresse für die Instanz aus.

Müssen Sie eine Verbindung von Clients außerhalb des Google Cloud VPC-Netzwerk über das öffentliche Internet herstellen?

Wenn ja, wählen Sie eine öffentliche IP-Adresse für die Instanz aus.
Konfigurationsoptionen

Die folgenden Arten von privaten Netzwerkkonfigurationen werden unterstützt:

Wenn Sie über eine öffentliche IP-Adresse eine direkte Verbindung zu einer Instanz herstellen, müssen Sie autorisierte Netzwerke konfigurieren.

Eine weitere sicherere Alternative zum Herstellen einer Verbindung zu einer Cloud SQL-Instanz, die eine öffentliche IP-Adresse verwendet , ist die Verwendung eines Cloud SQL-Connectors (z. B. des Cloud SQL Auth-Proxys oder eines der Cloud SQL Language Connectors).

Eine Anleitung zum Hinzufügen einer öffentlichen IP-Adresse zu Ihrer Instanz finden Sie unter Öffentliche IP-Adressen konfigurieren.

Wenn Sie über eine öffentliche IP-Adresse eine Verbindung zu einer Cloud SQL-Instanz herstellen möchten, können Sie den psql Client oder einen anderen verfügbaren Client verwenden.
Zusammenfassung

Empfehlung: Aus Sicherheitsgründen empfehlen wir, Ihre Instanz mit einer privaten IP-Adresse zu konfigurieren, es sei denn, Sie haben bestimmte Anforderungen an eine über das Internet zugängliche Cloud SQL-Instanz oder stellen eine Verbindung von einem Client aus her, der die Anforderungen für eine VPC nicht erfüllt.

Verbindungstyp: Cloud SQL-Connector oder direkt

Wenn Sie eine Verbindung zu einer Cloud SQL-Instanz herstellen, können Sie einen Cloud SQL-Connector verwenden oder eine direkte Verbindung herstellen.

Ein Cloud SQL-Connector ist entweder der Cloud SQL Auth-Proxy oder einer der Cloud SQL Language Connectors.

Cloud SQL-Connector Direkte Verbindung
Beschreibung Der Cloud SQL Auth-Proxy, ein clientseitiger Proxy, und die Cloud SQL Language Connectors, clientseitige Bibliotheken, ermöglichen einen vereinfachten und sicheren Zugriff auf Ihre Cloud SQL-Instanzen, insbesondere wenn Sie über eine öffentliche IP-Adresse eine Verbindung zu einer Instanz herstellen. Eine direkte Verbindung von einem Client zu einer Cloud SQL-Instanz bietet eine Verbindung mit geringerer Latenz. Eine direkte Verbindung kann entweder über eine öffentliche oder eine private IP-Adresse hergestellt werden.
Entscheidungspunkte

Cloud SQL-Connectors sind in den folgenden Szenarien von Vorteil:

  • Wenn Sie über eine öffentliche IP-Adresse eine Verbindung zu einer Cloud SQL-Instanz herstellen möchten ohne autorisierte Netzwerke konfigurieren zu müssen.
  • Wenn Sie den Traffic zur und von der Datenbank automatisch mit Server und Clientidentitätsprüfung verschlüsseln möchten, ohne SSL-Zertifikate verwalten zu müssen.
  • Wenn Sie die IAM-Datenbankauthentifizierung verwenden und Ihre OAuth 2.0-Zugriffstokens automatisch aktualisieren möchten.
  • Wenn Sie eine Verbindung von einem Client oder einer Anwendung aus herstellen, die eine dynamisch zugewiesene oder sitzungsspezifische IP-Adresse verwendet. Die dynamische IP-Konfiguration ist bei PaaS-Anwendungen (Platform as a Service) üblich.

Die Verwendung einer direkten Verbindung bietet folgende Vorteile:

  • Geringere Latenz im Vergleich zu Verbindungen mit Cloud SQL-Connectors.
  • Keine zusätzliche Paket- oder Bibliotheksabhängigkeit im Gegensatz zu Cloud SQL-Connectors.
  • Wenn Sie eine direkte Verbindung verwenden, sind Sie für die Konfiguration der SSL/TLS-Einstellungen verantwortlich.
Konfigurationsoptionen

So konfigurieren Sie SSL/TLS-Zertifikate für die Cloud SQL-Instanz und für Ihren Client:

  1. Wählen Sie einen Modus für die Serverzertifizierungsstelle für Ihre Instanz aus.
  2. Konfigurieren Sie Ihre Instanz so, dass die SSL/TLS-Verschlüsselung für Verbindungen zur Instanz erzwungen wird.
  3. Erstellen Sie Clientzertifikate.
  4. Laden Sie Ihre Server- und Clientzertifikate herunter.
Zusammenfassung

Wenn Sie eine Verbindung zu einer Cloud SQL-Instanz herstellen, können Sie entweder einen Cloud SQL-Connector verwenden oder eine direkte Verbindung von Clients aus herstellen.

Allgemeine Empfehlung: Wenn Sie über eine private IP-Adresse eine Verbindung zu einer Instanz herstellen, verwenden Sie eine direkte Verbindung. Wir empfehlen außerdem, SSL zu erzwingen und SSL/TLS-Zertifikate für Ihre Verbindung zu konfigurieren.

Wenn Sie über eine öffentliche IP-Adresse eine Verbindung zu einer Instanz herstellen, verwenden Sie einen Cloud SQL-Connector (entweder den Cloud SQL Auth-Proxy oder einen der Cloud SQL Language Connectors).

Datenbankauthentifizierungstyp: IAM oder integriert

Wenn Sie eine Verbindung zu einer Instanz herstellen, müssen Sie sich als Datenbanknutzer authentifizieren. Sie können zwischen der integrierten Authentifizierung oder der IAM-Datenbankauthentifizierung wählen.

IAM-Datenbankauthentifizierung Integrierte Authentifizierung
Beschreibung Mit der IAM-Datenbankauthentifizierung können Sie sich mit IAM-Nutzer- und Dienstkonten bei Datenbanken authentifizieren. Google Cloud Dabei werden anstelle von Passwörtern kurzlebige Zugriffstokens verwendet. Sie können Datenbankberechtigungen mit IAM-Hauptkonten wie Nutzern, Dienstkonten und Gruppen verwalten. Bei der integrierten Authentifizierung werden lokale Nutzernamen und Passwörter der Datenbank verwendet, um Datenbanknutzer zu authentifizieren.
Entscheidungspunkte Möchten Sie die Nutzerverwaltung mit IAM zentralisieren Google Cloud Google Cloud? Wenn ja, verwenden Sie die IAM-Datenbankauthentifizierung. Haben Sie Anwendungen oder Workflows, die von der integrierten Datenbankauthentifizierung abhängig sind? Wenn ja, verwenden Sie die integrierte Authentifizierung.
Konfigurationsoptionen

Sie können die IAM-Datenbankauthentifizierung für einzelne IAM-Nutzer, einzelne Dienstkonten und Gruppen verwenden. Weitere Informationen finden Sie unter use Nutzer mit IAM-Datenbankauthentifizierung verwalten .

Wenn Sie einen Cloud SQL-Connector verwenden, übernimmt der Connector die automatische Aktualisierung der IAM-Zugriffstokens. Weitere Informationen finden Sie unter Automatische IAM-Datenbankauthentifizierung.

 Sie können die integrierte Datenbankauthentifizierung verwenden und Passwort richtlinien auf Instanz- und Nutzerebene konfigurieren. Weitere Informationen finden Sie unter Integrierte Authentifizierung.
Zusammenfassung Empfehlung: Sofern Sie keine Anwendungen oder Workflows haben, die von der integrierten Datenbankauthentifizierung abhängig sind, sollten Sie nach Möglichkeit die IAM-Datenbankauthentifizierung verwenden.

Optionen für private Netzwerke bei Verwendung einer privaten IP-Adresse

Wenn Sie Ihre Instanz für die Verwendung einer privaten IP-Adresse konfigurieren, können Sie die folgenden Optionen für private Netzwerke auswählen: Zugriff auf private Dienste, Private Service Connect oder beides.

Unterstützte Features

In der folgenden Tabelle sind die Features aufgeführt, die Cloud SQL unterstützt, wenn Sie eine Verbindung zu einer Instanz herstellen, die mit einer oder beiden Optionen für private Netzwerke konfiguriert ist.

Feature Instanz mit nur Zugriff auf private Dienste Instanz mit nur Private Service Connect Instanz mit Zugriff auf private Dienste und Private Service Connect
Verbindung von mehreren VPCs Nicht unterstützt. Unterstützt. Unterstützt durch Verwendung des Private Service Connect-Endpunkts.
pglogical, PL/Proxy, dblink, und postgres_fdw Erweiterungen Unterstützt. Nicht unterstützt. Unterstützt durch Verwendung der ausgehenden Verbindung für den Zugriff auf private Dienste.
Externe Replikate Unterstützt. Nicht unterstützt. Unterstützt durch Verwendung der ausgehenden Verbindung für den Zugriff auf private Dienste.
Schreibendpunkt Unterstützt. Nicht unterstützt. Unterstützt für den Zugriff auf private Dienste.
Zugeordnetes VPC-Netzwerk für den Zugriff auf private Dienste ändern Unterstützt. Nicht zutreffend. Nicht unterstützt für den Zugriff auf private Dienste, da für die Instanz Private Service Connect aktiviert ist. Nicht zutreffend für Private Service Connect.
Sichtbarkeit der Client-IP-Adresse für Cloud SQL Unterstützt. Nicht unterstützt. Unterstützt durch Verwendung der IP-Adresse für den Zugriff auf private Dienste. Nicht unterstützt durch Verwendung des Private Service Connect-Endpunkts.

Netzwerkoptionen aus einer Instanz entfernen

Cloud SQL unterstützt das Entfernen der folgenden Netzwerkoptionen aus einer Instanz:

  • Öffentliche IP-Adresse aus einer Instanz mit Zugriff auf private Dienste und öffentlicher IP-Adresse
  • Öffentliche IP-Adresse aus einer Instanz mit öffentlicher IP-Adresse, Zugriff auf private Dienste und Private Service Connect
  • Private Service Connect aus einer Instanz mit Private Service Connect und Zugriff auf private Dienste
  • Private Service Connect aus einer Instanz mit Private Service Connect, Zugriff auf private Dienste und öffentlicher IP-Adresse

Netzwerkoptionen für eine Instanz aktivieren

Sie können die folgenden Verbindungsoptionen für Instanzen aktivieren:

  • Zugriff auf private Dienste für eine Instanz mit nur öffentlicher IP-Adresse
  • Private Service Connect für eine Instanz mit nur Zugriff auf private Dienste
  • Private Service Connect für eine Instanz mit Zugriff auf private Dienste und öffentlicher IP-Adresse
  • Öffentliche IP-Adresse für eine Instanz mit nur Zugriff auf private Dienste

Beschränkungen

  • Sie können keine Instanz mit einer öffentlichen IP-Adresse und Private Service Connect erstellen.
  • Sie können den Zugriff auf private Dienste nicht aus einer Instanz mit Zugriff auf private Dienste und Private Service Connect entfernen.
  • Sie können den Zugriff auf private Dienste nicht aus einer Instanz mit Zugriff auf private Dienste und öffentlicher IP-Adresse entfernen.
  • Wenn Sie eine Instanz haben, die nur eine öffentliche IP-Adresse verwendet, können Sie nicht gleichzeitig den Zugriff auf private Dienste und Private Service Connect aktivieren. Aktivieren Sie zuerst den Zugriff auf private Dienste und dann Private Service Connect.
  • Sie können autorisierte Netzwerke nicht verwenden, um IP-Adressen für Private Service Connect-Instanzen auf die Zulassungsliste zu setzen.

Tools zum Herstellen einer Verbindung zu Cloud SQL

Die folgende Tabelle enthält einige Optionen für die Verbindung zu Cloud SQL:

Verbindungsoption Weitere Informationen
Cloud SQL Auth-Proxy
gcloud CLI
Cloud SQL-Sprachverbindungen
Cloud Shell
Cloud Code
Google Cloud Data Agent Kit
Verbindung mithilfe von Drittanbieter-Datenbankverwaltungstools herstellen
pgAdmin
Toad Edge
Blendo

Fehlerbehebung

Wenn beim Herstellen der Verbindung Probleme auftreten, lesen Sie die folgenden Seiten für das Debugging oder zur Suche nach Lösungen für bekannte Probleme:

Nächste Schritte