Conectar o psql a um banco de dados do dialeto PostgreSQL

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ê executa psql.
  • Usar uma instância do PGAdapter em execução: inicie e gerencie o processo de proxy do PGAdapter separadamente. Em seguida, conecte psql a localhost.

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.

  1. Instale o psql no PATH e o spgc seguindo as instruções em Iniciar o PGAdapter.

  2. Configure o Application Default Credentials (ADC), por exemplo, executando gcloud auth application-default login ou definindo GOOGLE_APPLICATION_CREDENTIALS.

  3. Execute psql por meio de spgc especificando 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_PROJECT e SPANNER_INSTANCE (e, opcionalmente, SPANNER_DATABASE):

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID
    export SPANNER_INSTANCE=INSTANCE_ID
    
    spgc psql -d DATABASE_ID
    
  4. Opcional: verifique se o psql se 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:

  1. Inicie o PGAdapter na mesma máquina que o comando psql.

    Para mais informações, consulte Iniciar o PGAdapter.

  2. Em uma janela do terminal, inicie psql e especifique localhost como 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; ..."] ...

  3. Opcional: verifique se o psql se 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