Receber o PGAdapter

Este documento explica como receber 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 no 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 receber 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 distroless com a 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 fazer o download do arquivo JAR e das dependências mais recentes, 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 fazer o download de 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 dependências da origem, execute os seguintes comandos:

  1. Clone o repositório:

    git clone https://github.com/GoogleCloudPlatform/pgadapter.git

  2. Criar 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.55.3</version>
</dependency>

A seguir