Cette page explique comment connecter psql à une base de données utilisant le dialecte PostgreSQL dans Spanner.
psql est l'interface de ligne de commande de PostgreSQL.
Vous pouvez connecter psql à Spanner de deux manières :
- Utiliser le connecteur Spanner PG (
spgc) :spgcest un wrapper de CLI autonome qui regroupe PGAdapter et un environnement d'exécution Java minimal. Il démarre et arrête PGAdapter en arrière-plan lorsque vous exécutezpsql. - Utiliser une instance PGAdapter en cours d'exécution : démarrez et gérez le processus de proxy PGAdapter séparément. Ensuite, connectez
psqlàlocalhost.
Se connecter à l'aide du connecteur Spanner PG (spgc)
spanner-pg-connector (alias spgc) vous permet d'exécuter psql sans installer Java ou Docker, ni gérer manuellement un processus PGAdapter distinct.
Installez
psqlsur votrePATH, puis installezspgcen suivant les instructions de la section Démarrer PGAdapter.Configurez les identifiants par défaut de l'application (ADC), par exemple en exécutant
gcloud auth application-default loginou en définissantGOOGLE_APPLICATION_CREDENTIALS.Exécutez
psqlviaspgcen spécifiant le nom complet de la ressource de base de données :spgc psql -d "projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID"Vous pouvez également définir
GOOGLE_CLOUD_PROJECTetSPANNER_INSTANCE(et éventuellementSPANNER_DATABASE) :export GOOGLE_CLOUD_PROJECT=PROJECT_ID export SPANNER_INSTANCE=INSTANCE_ID spgc psql -d DATABASE_IDFacultatif : Vérifiez que
psqlest connecté à une base de données de dialecte PostgreSQL en exécutant la requête suivante :SELECT 1::bigint;Cette requête n'est pas compatible avec les bases de données de dialecte GoogleSQL.
Se connecter à une instance PGAdapter en cours d'exécution
Si vous exécutez PGAdapter en tant que processus ou conteneur distinct :
Démarrez PGAdapter sur la même machine que la commande
psql.Pour en savoir plus, consultez Démarrer PGAdapter.
Dans une fenêtre de terminal, démarrez
psqlet spécifiezlocalhostcomme hôte du serveur de base de données.- Vous pouvez éventuellement spécifier un numéro de port si PGAdapter est configuré pour écouter sur un port autre que le port PostgreSQL par défaut (5432).
- Vous pouvez éventuellement spécifier une ou plusieurs commandes à envoyer à la base de données ou au pilote (par exemple, le pilote JDBC). Pour chaque occurrence de l'option
-c, vous pouvez spécifier une seule commande ou un lot de commandes séparées par des points-virgules (;). Pour en savoir plus, consultez Outil de ligne de commande psql.
psql -h localhost [-p PORT] [-c "COMMAND; ..."] ...Facultatif : Vérifiez que
psqls'est bien connecté à une base de données de dialecte PostgreSQL en envoyant la requête suivante :SELECT 1::bigint;Cette requête n'est pas compatible avec les bases de données de dialecte GoogleSQL.
Étapes suivantes
- En savoir plus sur PGAdapter
- Consultez les commandes
psqlcompatibles dans Outil de ligne de commande psql.