psql mit einer Datenbank im PostgreSQL-Dialekt verbinden

Auf dieser Seite wird beschrieben, wie Sie psql mit einer Datenbank im PostgreSQL-Dialekt in Spanner verbinden. psql ist das Befehlszeilen-Frontend für PostgreSQL.

Sie haben zwei Möglichkeiten, psql mit Spanner zu verbinden:

  • Mit Spanner PG Connector (spgc): spgc ist ein eigenständiger CLI-Wrapper, der PGAdapter und eine minimale Java-Laufzeit bündelt. PGAdapter wird im Hintergrund gestartet und beendet, wenn Sie psql ausführen.
  • Ausgeführte PGAdapter-Instanz verwenden: Starten und verwalten Sie den PGAdapter-Proxyprozess separat. Verbinden Sie dann psql mit localhost.

Verbindung über Spanner PG Connector (spgc) herstellen

Mit spanner-pg-connector (Alias spgc) können Sie psql ausführen, ohne Java oder Docker zu installieren oder einen separaten PGAdapter-Prozess manuell zu verwalten.

  1. Installieren Sie psql auf Ihrem PATH und installieren Sie spgc. Folgen Sie dazu der Anleitung unter PGAdapter starten.

  2. Konfigurieren Sie die Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC), z. B. durch Ausführen von gcloud auth application-default login oder Festlegen von GOOGLE_APPLICATION_CREDENTIALS.

  3. Führen Sie psql bis spgc aus, indem Sie den vollständigen Namen der Datenbankressource angeben:

    spgc psql -d "projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID"
    

    Alternativ können Sie GOOGLE_CLOUD_PROJECT und SPANNER_INSTANCE (und optional SPANNER_DATABASE) festlegen:

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    export SPANNER_INSTANCE=INSTANCE_ID
    
    spgc psql -d DATABASE_ID
    
  4. Optional: Prüfen Sie mit der folgenden Abfrage, ob psql mit einer Datenbank im PostgreSQL-Dialekt verbunden ist:

    SELECT 1::bigint;
    

    Diese Abfrage ist nicht mit Datenbanken im GoogleSQL-Dialekt kompatibel.

Verbindung zu einer laufenden PGAdapter-Instanz herstellen

Wenn Sie PGAdapter als separaten Prozess oder Container ausführen:

  1. Starten Sie PGAdapter auf demselben Computer wie den Befehl psql.

    Weitere Informationen finden Sie unter PGAdapter starten.

  2. Starten Sie in einem Terminalfenster psql und geben Sie localhost als Datenbankserver-Host an.

    • Geben Sie optional eine Portnummer an, wenn PGAdapter so konfiguriert ist, dass er auf einem anderen Port als dem PostgreSQL-Standardport (5432) lauscht.
    • Geben Sie optional einen oder mehrere Befehle an, die an die Datenbank oder den Treiber (z. B. den JDBC-Treiber) gesendet werden sollen. Für jedes Vorkommen der Option -c können Sie einen einzelnen Befehl oder eine Reihe von Befehlen angeben, die durch Semikolons (;) getrennt sind. Weitere Informationen finden Sie unter psql-Befehlszeilentool.

    psql -h localhost [-p PORT] [-c "COMMAND; ..."] ...

  3. Optional: Prüfen Sie, ob psql erfolgreich eine Verbindung zu einer Datenbank im PostgreSQL-Dialekt hergestellt hat, indem Sie die folgende Abfrage senden:

    SELECT 1::bigint;

    Diese Abfrage ist nicht mit Datenbanken im GoogleSQL-Dialekt kompatibel.

Nächste Schritte