Nesta página, explicamos como conectar o psql a um banco de dados de dialeto PostgreSQL no Spanner.
psql é o front-end de linha de comando do PostgreSQL.
É possível conectar o psql ao Spanner de duas maneiras:
- Como usar o conector PG do Spanner (
spgc):spgcé um wrapper de CLI independente que agrupa o PGAdapter e um ambiente de execução Java mínimo. Ele inicia e interrompe o PGAdapter em segundo plano quando você executapsql. - Usar uma instância do PGAdapter em execução: inicie e gerencie o
processo de proxy do PGAdapter separadamente. Em seguida, conecte
psqlalocalhost.
Conectar usando o conector PG do Spanner (spgc)
O spanner-pg-connector (com o alias spgc) permite executar o psql sem
instalar o Java ou o Docker ou gerenciar manualmente um processo separado do
PGAdapter.
Instale o
psqlnoPATHe ospgcseguindo as instruções em Iniciar o PGAdapter.Configure o Application Default Credentials (ADC), por exemplo, executando
gcloud auth application-default loginou definindoGOOGLE_APPLICATION_CREDENTIALS.Execute
psqlpor meio despgcespecificando o nome completo do recurso do banco de dados:spgc psql -d "projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID"Como alternativa, defina
GOOGLE_CLOUD_PROJECTeSPANNER_INSTANCE(e, opcionalmente,SPANNER_DATABASE):export GOOGLE_CLOUD_PROJECT=PROJECT_ID export SPANNER_INSTANCE=INSTANCE_ID spgc psql -d DATABASE_IDOpcional: verifique se o
psqlse conectou a um banco de dados de dialeto PostgreSQL executando a seguinte consulta:SELECT 1::bigint;Essa consulta é incompatível com bancos de dados do dialeto GoogleSQL.
Conectar-se a uma instância do PGAdapter em execução
Se você estiver executando o PGAdapter como um processo ou contêiner separado:
Inicie o PGAdapter na mesma máquina que o comando
psql.Para mais informações, consulte Iniciar o PGAdapter.
Em uma janela do terminal, inicie
psqle especifiquelocalhostcomo o host do servidor de banco de dados.- Se quiser, especifique um número de porta se o PGAdapter estiver configurado para detectar uma porta diferente da padrão do PostgreSQL (5432).
- Opcionalmente, especifique um ou mais comandos para enviar ao banco de dados ou driver
(por exemplo, o driver JDBC). Para cada ocorrência da opção
-c, é possível especificar um único comando ou um lote de comandos separados por ponto e vírgula (;). Para mais informações, consulte Ferramenta de linha de comando psql.
psql -h localhost [-p PORT] [-c "COMMAND; ..."] ...Opcional: verifique se o
psqlse conectou a um banco de dados de dialeto PostgreSQL enviando a seguinte consulta:SELECT 1::bigint;Essa consulta é incompatível com bancos de dados do dialeto GoogleSQL.
A seguir
- Saiba mais sobre o PGAdapter.
- Consulte os comandos
psqlcompatíveis na ferramenta de linha de comando psql.