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):spgces 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 ejecutaspsql. - Usa una instancia de PGAdapter en ejecución: inicia y administra el proceso de proxy de PGAdapter por separado. Luego, conecta
psqlalocalhost.
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.
Instala
psqlen tuPATHy, luego, instalaspgcsiguiendo las instrucciones que se indican en Inicia PGAdapter.Configura las credenciales predeterminadas de la aplicación (ADC), por ejemplo, ejecutando
gcloud auth application-default logino configurandoGOOGLE_APPLICATION_CREDENTIALS.Ejecuta
psqla través despgcespecificando 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_PROJECTySPANNER_INSTANCE(y, de manera opcional,SPANNER_DATABASE):export GOOGLE_CLOUD_PROJECT=PROJECT_ID export SPANNER_INSTANCE=INSTANCE_ID spgc psql -d DATABASE_IDOpcional: Ejecuta la siguiente consulta para verificar que
psqlse 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:
Inicia PGAdapter en la misma máquina que el comando
psql.Para obtener más información, consulta Inicia PGAdapter.
En una ventana de terminal, inicia
psqly especificalocalhostcomo 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; ..."] ...Opcional: Ejecuta la siguiente consulta para verificar que
psqlse 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?
- Obtén más información sobre PGAdapter.
- Consulta los comandos
psqladmitidos en la herramienta de línea de comandos de psql.