Verbindung zu einem Datenbankcluster herstellen

Standardmäßig lässt ein Datenbankcluster nur Verbindungen innerhalb des Nutzerclusters und desselben Projekts zu.

Informationen zum Aktivieren von Verbindungen zu allen Datenbankclustern in Ihrem Projekt von einem anderen Projekt aus finden Sie unter Projektübergreifende Verbindungen aktivieren.

Informationen zum Aktivieren von Verbindungen zu einem Datenbankcluster von IP-Adressen außerhalb Ihrer GDC-Organisation finden Sie unter Externe Verbindungen aktivieren.

Melden Sie sich mit einem Konto, das an die Rolle „Database Project Admin“ gebunden ist, in der GDC-Konsole an, um die folgenden Informationen zum Herstellen einer Verbindung zu Ihrem Datenbankcluster zu finden. Diese Informationen finden Sie im Abschnitt Konnektivität auf der Seite Datenbankdienst.

Diese Schritte enthalten ein Beispiel für die Verbindung zur Datenbank mit psql. Die genauen Schritte hängen von der ausgewählten Clientsoftware ab.

Console

  1. Rufen Sie auf der Seite Datenbankdienst für den Datenbankcluster den Abschnitt Konnektivität auf. Diese Seite enthält:

    • Das Passwort des Administratorkontos (der Nutzername ist dbsadmin)
    • Hostname und Portnummer des primären Endpunkts des Datenbankclusters
    • Gibt an, ob der Datenbankcluster externe Verbindungen von außerhalb der Organisation zulässt.
    • Einen psql-Befehl zum Herstellen einer Verbindung zum Cluster
    • Ein Link zum Herunterladen des Zertifikats der Zertifizierungsstelle (Certificate Authority, CA) des Datenbankclusters

  2. Laden Sie das CA-Zertifikat aus der GDC-Konsole im Abschnitt Konnektivität der Seite Datenbankdienst für Ihren Datenbankcluster herunter.

  3. Konfigurieren Sie Ihren Client so, dass er das CA-Zertifikat zur Überprüfung der Datenbank verwendet. Legen Sie für psql-Clients die Umgebungsvariable PGSSLROOTCERT auf den Pfad der Zertifikatsdatei und die Umgebungsvariable PGSSLMODE auf Ihre Einstellung fest:

    export PGSSLROOTCERT=path/to/accounts_cert.pem
export PGSSLMODE="verify-full"

  4. Stellen Sie über Ihre Clientsoftware eine Verbindung zur Datenbank her. Wenn Sie psql verwenden, führen Sie den folgenden Befehl aus:

    PGPASSWORD=DB_PASSWORD psql -h DB_HOSTNAME -p PORT -U USERNAME -d postgres

Ersetzen Sie die folgenden Variablen:

  • path/to/: der Pfad zum accounts_cert.pem-Zertifikat.
  • DB_PASSWORD: das Passwort aus der Console.
  • DB_HOSTNAME: der Datenbank-Hostname aus der Console.
  • DB_PORT: die Datenbankportnummer aus der Console.
  • DB_USERNAME: der Datenbanknutzername aus der Console.

API

  1. Rufen Sie den Datenbankendpunkt aus dem Datenbankclusterstatus ab:

    kubectl get dbcluster.postgresql.dbadmin.gdc.goog DBCLUSTER_NAME -n USER_PROJECT -o=jsonpath='{.status.primary.url}'

  2. Laden Sie das CA-Zertifikat aus dem Kubernetes-Secret herunter:

    kubectl get secret dbs-certificates -n USER_PROJECT -o json | jq -r '.data."dbs-pg-cert-DBCLUSTER_NAME"' | base64 -d > path/to/ca.crt

  3. Konfigurieren Sie Ihren Client so, dass er das CA-Zertifikat zur Überprüfung der Datenbank verwendet. Bei psql-Clients können Sie die Umgebungsvariable PGSSLROOTCERT auf den Pfad der Zertifikatsdatei und die Umgebungsvariable PGSSLMODE auf Ihre bevorzugte Einstellung festlegen:

    export PGSSLROOTCERT=path/to/ca.crt
export PGSSLMODE="verify-full"

  4. Stellen Sie über Ihre Clientsoftware eine Verbindung zur Datenbank her. Wenn Sie psql verwenden, führen Sie den folgenden Befehl aus:

    PGPASSWORD=DB_PASSWORD psql -h DB_HOSTNAME -p DB_PORT -U DB_USERNAME -d postgres

Ersetzen Sie die folgenden Variablen:

  • USER_PROJECT: der Name des Nutzerprojekts, in dem der Datenbankcluster erstellt wurde.
  • DBCLUSTER_NAME: Der Name des Datenbankclusters.
  • path/to/: der Pfad zum CA-Zertifikat der Datenbank.
  • DB_PASSWORD: Datenbankpasswort für den Administrator.
  • DB_HOSTNAME: der Hostname aus dem Datenbankclusterstatus.
  • DB_PORT: die Datenbankportnummer aus dem Datenbankclusterstatus.
  • DB_USERNAME: durch den Datenbanknutzernamen (Standard ist dbsadmin).