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):spgcist ein eigenständiger CLI-Wrapper, der PGAdapter und eine minimale Java-Laufzeit bündelt. PGAdapter wird im Hintergrund gestartet und beendet, wenn Siepsqlausführen. - Ausgeführte PGAdapter-Instanz verwenden: Starten und verwalten Sie den PGAdapter-Proxyprozess separat. Verbinden Sie dann
psqlmitlocalhost.
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.
Installieren Sie
psqlauf IhremPATHund installieren Siespgc. Folgen Sie dazu der Anleitung unter PGAdapter starten.Konfigurieren Sie die Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC), z. B. durch Ausführen von
gcloud auth application-default loginoder Festlegen vonGOOGLE_APPLICATION_CREDENTIALS.Führen Sie
psqlbisspgcaus, 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_PROJECTundSPANNER_INSTANCE(und optionalSPANNER_DATABASE) festlegen:export GOOGLE_CLOUD_PROJECT=PROJECT_ID export SPANNER_INSTANCE=INSTANCE_ID spgc psql -d DATABASE_IDOptional: Prüfen Sie mit der folgenden Abfrage, ob
psqlmit 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:
Starten Sie PGAdapter auf demselben Computer wie den Befehl
psql.Weitere Informationen finden Sie unter PGAdapter starten.
Starten Sie in einem Terminalfenster
psqlund geben Sielocalhostals 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
-ckö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; ..."] ...Optional: Prüfen Sie, ob
psqlerfolgreich 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
- PGAdapter
- Die unterstützten
psql-Befehle finden Sie im psql-Befehlszeilentool.