Receber o PGAdapter

Neste documento, explicamos como conseguir o binário do PGAdapter. Use o PGAdapter com bancos de dados de dialeto PostgreSQL.

Execute o PGAdapter em um contêiner do Docker, como um processo independente ou em processo com um aplicativo Java.

Executar em um contêiner do Docker

Execute o PGAdapter em um contêiner do Docker usando uma das seguintes opções:

Imagem padrão

Para receber a versão mais recente da imagem padrão, execute o seguinte comando:

docker pull gcr.io/cloud-spanner-pg-adapter/pgadapter

Para acessar uma versão anterior, anexe a versão como uma tag:

docker pull gcr.io/cloud-spanner-pg-adapter/pgadapter:vVERSION_NUMBER

Imagem distroless

Também publicamos uma imagem Docker sem distribuição na tag gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless. Essa imagem executa o PGAdapter como um usuário não raiz.

Para extrair a imagem distroless, execute o seguinte comando:

docker pull gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless

Executar como um processo independente

Execute o PGAdapter como um processo independente na JVM recebendo o arquivo JAR usando uma das seguintes opções:

JAR pré-criado (versão mais recente)

Para baixar o arquivo JAR mais recente e as dependências, execute o seguinte comando:

wget https://storage.googleapis.com/pgadapter-jar-releases/pgadapter.tar.gz \
  && tar -xzvf pgadapter.tar.gz

JAR pré-criado (versão específica)

Para baixar uma versão específica do arquivo JAR, defina a versão ao fazer o download.

VERSION=VERSION_NUMBER
wget https://storage.googleapis.com/pgadapter-jar-releases/pgadapter-${VERSION}.tar.gz \
  && tar -xzvf pgadapter-${VERSION}.tar.gz

JAR criado localmente (da origem)

Para criar o arquivo JAR e montar as dependências da origem, execute os seguintes comandos:

  1. Clone o repositório:

    git clone https://github.com/GoogleCloudPlatform/pgadapter.git
    
  2. Crie o pacote:

    mvn package -P assembly
    

O processo de build cria os binários na pasta target/pgadapter.

Usar em um processo Java

Adicione google-cloud-spanner-pgadapter como uma dependência ao seu projeto.

Maven

Se você usa o Maven, adicione a seguinte dependência ao arquivo pom.xml:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-spanner-pgadapter</artifactId>
  <version>0.56.4</version>
</dependency>

Usar o conector PG do Spanner (spgc)

Para executar ferramentas de linha de comando do PostgreSQL, como psql ou pg_dump, sem instalar o Java ou o Docker, use spanner-pg-connector (com o alias spgc). O spgc agrupa o PGAdapter e um ambiente de execução Java mínimo. Para instruções de instalação e uso, consulte Iniciar o PGAdapter.

A seguir