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:
Clone o repositório:
git clone https://github.com/GoogleCloudPlatform/pgadapter.gitCrie 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:
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
- Saiba como iniciar o PGAdapter.