Verbindung zu Cloud SQL herstellen

Auf dieser Seite finden Sie eine Übersicht ü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, wie Sie Ihre Clients mit der vorhandenen Instanz verbinden können.

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 die Instanz konfiguriert haben, geben Sie entweder eine öffentliche IP-Adresse, eine private IP-Adresse oder in einigen Fällen einen DNS-Namen in der Clientverbindungsstring an.

Private IP-Adresse Öffentliche IP-Adresse
Beschreibung Interne IP-Adresse (privat), die nur für das VPC-Netzwerk (Virtual Private Cloud) gilt Eine externe, über das Internet zugängliche IP-Adresse (öffentlich)
Entscheidungspunkte

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

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:

  • Private Service Connect: Sie können eine Verbindung zu Cloud SQL-Instanzen aus mehreren VPC-Netzwerken herstellen, die zu verschiedenen Gruppen, Projekten oder Organisationen gehören. Private Service Connect ist die Standardoption für private IP-Verbindungen für neue Projekte.
  • Privater Dienstzugriff: Sie können eine Verbindung zu Cloud SQL-Instanzen aus einem einzelnen VPC-Netzwerk basierend auf VPC-Netzwerk-Peering herstellen.

    • Weitere Informationen zur Auswahl einer privaten Netzwerkkonfiguration finden Sie unter Optionen für die Konfiguration privater IP-Adressen.

Wenn Sie eine direkte Verbindung zu einer Instanz über eine öffentliche IP-Adresse 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-Adresse konfigurieren.

Wenn Sie eine Verbindung zu einer Cloud SQL-Instanz über eine öffentliche IP-Adresse 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 eine Verbindung zu einer Instanz über eine öffentliche IP-Adresse herstellen. Eine direkte Verbindung von einem Client zu einer Cloud SQL-Instanz bietet eine Verbindung mit geringerer Latenz. Eine direkte Verbindung kann über eine öffentliche oder eine private IP-Adresse hergestellt werden.
Entscheidungspunkte

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

  • Wenn Sie eine Verbindung zu einer Cloud SQL-Instanz über eine öffentliche IP-Adresse herstellen möchten ohne autorisierte Netzwerke konfigurieren zu müssen.
  • Wenn Sie den Traffic zur und von der Datenbank automatisch mit der Server- und Client-Identitätsüberprü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 für 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 wie bei 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 auf der Cloud SQL-Instanz und für Ihren Client:

  1. Wählen Sie einen Server-CA-Modus für Ihre Instanz aus.
  2. Konfigurieren Sie die 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 eine Verbindung zu einer Instanz über eine private IP-Adresse 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 eine Verbindung zu einer Instanz über eine öffentliche IP-Adresse 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 Arbeitsabläufe, 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 Arbeitsabläufe haben, die von der integrierten Datenbankauthentifizierung abhängig sind, sollten Sie nach Möglichkeit die IAM-Datenbankauthentifizierung verwenden.

Netzwerkoptionen aus einer Instanz entfernen

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

  • Öffentliche IP-Adresse aus einer Instanz mit privatem Dienstzugriff und öffentlicher IP-Adresse
  • Öffentliche IP-Adresse aus einer Instanz mit öffentlicher IP-Adresse, privatem Dienstzugriff und Private Service Connect
  • Private Service Connect aus einer Instanz mit Private Service Connect und privatem Dienstzugriff
  • Private Service Connect aus einer Instanz mit Private Service Connect, privatem Dienstzugriff und öffentlicher IP-Adresse

Netzwerkoptionen für eine Instanz aktivieren

Cloud SQL unterstützt das Aktivieren der folgenden Verbindungsoptionen für Instanzen:

  • Privater Dienstzugriff auf einer Instanz mit nur öffentlicher IP-Adresse
  • Private Service Connect auf einer Instanz mit nur privatem Dienstzugriff
  • Private Service Connect auf einer Instanz mit privatem Dienstzugriff und öffentlicher IP-Adresse
  • Öffentliche IP-Adresse auf einer Instanz mit nur privatem Dienstzugriff

Beschränkungen

  • Sie können keine Instanz mit einer öffentlichen IP-Adresse und Private Service Connect erstellen.
  • Sie können den privaten Dienstzugriff nicht aus einer Instanz mit privatem Dienstzugriff und Private Service Connect entfernen.
  • Sie können den privaten Dienstzugriff nicht aus einer Instanz mit privatem Dienstzugriff und öffentlicher IP-Adresse entfernen.
  • Wenn Sie eine Instanz haben, die nur eine öffentliche IP-Adresse verwendet, können Sie nicht gleichzeitig den privaten Dienstzugriff und Private Service Connect aktivieren. Aktivieren Sie zuerst den privaten Dienstzugriff und dann Private Service Connect.
  • Sie können keine autorisierten Netzwerke 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 Sie Probleme beim Herstellen einer Verbindung haben, finden Sie auf den folgenden Seiten Hilfe bei der Fehlerbehebung oder Lösungen für bekannte Probleme:

Nächste Schritte