Conecta psql a una base de datos de dialecto de PostgreSQL

En esta página, se explica cómo conectar psql a una base de datos de dialecto de PostgreSQL en Spanner. psql es la interfaz de línea de comandos para PostgreSQL.

Puedes conectar psql a Spanner de dos maneras:

  • Usa el conector de PG de Spanner (spgc): spgc es un wrapper de la CLI independiente que agrupa PGAdapter y un entorno de ejecución de Java mínimo. Inicia y detiene PGAdapter en segundo plano cuando ejecutas psql.
  • Usa una instancia de PGAdapter en ejecución: inicia y administra el proceso de proxy de PGAdapter por separado. Luego, conecta psql a localhost.

Conéctate con Spanner PG Connector (spgc)

spanner-pg-connector (con el alias spgc) te permite ejecutar psql sin instalar Java o Docker, ni administrar de forma manual un proceso de PGAdapter independiente.

  1. Instala psql en tu PATH y, luego, instala spgc siguiendo las instrucciones que se indican en Inicia PGAdapter.

  2. Configura las credenciales predeterminadas de la aplicación (ADC), por ejemplo, ejecutando gcloud auth application-default login o configurando GOOGLE_APPLICATION_CREDENTIALS.

  3. Ejecuta psql a través de spgc especificando el nombre completo del recurso de la base de datos:

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

    Como alternativa, configura GOOGLE_CLOUD_PROJECT y SPANNER_INSTANCE (y, de manera opcional, SPANNER_DATABASE):

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    export SPANNER_INSTANCE=INSTANCE_ID
    
    spgc psql -d DATABASE_ID
    
  4. Opcional: Ejecuta la siguiente consulta para verificar que psql se haya conectado a una base de datos con dialecto de PostgreSQL:

    SELECT 1::bigint;
    

    Esta consulta no es compatible con las bases de datos de dialecto de GoogleSQL.

Conéctate a una instancia de PGAdapter en ejecución

Si ejecutas PGAdapter como un proceso o contenedor independiente, haz lo siguiente:

  1. Inicia PGAdapter en la misma máquina que el comando psql.

    Para obtener más información, consulta Inicia PGAdapter.

  2. En una ventana de terminal, inicia psql y especifica localhost como el host del servidor de la base de datos.

    • De manera opcional, especifica un número de puerto si PGAdapter está configurado para escuchar en un puerto que no sea el predeterminado de PostgreSQL (5432).
    • De manera opcional, especifica uno o más comandos para enviar a la base de datos o al controlador (por ejemplo, el controlador de JDBC). Para cada caso de la opción -c, puedes especificar un solo comando o un lote de comandos separados por puntos y comas (;). Para obtener más información, consulta Herramienta de línea de comandos de psql.

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

  3. Opcional: Ejecuta la siguiente consulta para verificar que psql se haya conectado correctamente a una base de datos con dialecto de PostgreSQL:

    SELECT 1::bigint;

    Esta consulta no es compatible con las bases de datos de dialecto de GoogleSQL.

¿Qué sigue?