Connecter psql à une base de données en dialecte PostgreSQL

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) : spgc est 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écutez psql.
  • 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.

  1. Installez psql sur votre PATH, puis installez spgc en suivant les instructions de la section Démarrer PGAdapter.

  2. Configurez les identifiants par défaut de l'application (ADC), par exemple en exécutant gcloud auth application-default login ou en définissant GOOGLE_APPLICATION_CREDENTIALS.

  3. Exécutez psql via spgc en 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_PROJECT et SPANNER_INSTANCE (et éventuellement SPANNER_DATABASE) :

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    export SPANNER_INSTANCE=INSTANCE_ID
    
    spgc psql -d DATABASE_ID
    
  4. Facultatif : Vérifiez que psql est 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 :

  1. Démarrez PGAdapter sur la même machine que la commande psql.

    Pour en savoir plus, consultez Démarrer PGAdapter.

  2. Dans une fenêtre de terminal, démarrez psql et spécifiez localhost comme 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; ..."] ...

  3. Facultatif : Vérifiez que psql s'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