Obtén PGAdapter

En este documento, se explica cómo obtener el objeto binario de PGAdapter. Usa PGAdapter con bases de datos con dialecto de PostgreSQL.

Ejecuta PGAdapter en un contenedor de Docker, como un proceso independiente o en proceso con una aplicación de Java.

Ejecuta en un contenedor de Docker

Ejecuta PGAdapter en un contenedor de Docker con una de las siguientes opciones:

Imagen estándar

Para obtener la versión más reciente de la imagen estándar, ejecuta el siguiente comando:

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

Para obtener una versión anterior, agrega la versión como una etiqueta:

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

Imagen distroless

También publicamos una imagen de Docker distroless con la etiqueta gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless. Esta imagen ejecuta PGAdapter como un usuario no raíz.

Para extraer la imagen distroless, ejecuta el siguiente comando:

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

Ejecuta como un proceso independiente

Ejecuta PGAdapter como un proceso independiente en la JVM. Para ello, obtén el archivo JAR con una de las siguientes opciones:

JAR precompilado (versión más reciente)

Para descargar el archivo JAR y las dependencias más recientes, ejecuta el siguiente comando:

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

JAR precompilado (versión específica)

Para descargar una versión específica del archivo JAR, establece la versión cuando la descargues.

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

JAR compilado de forma local (desde la fuente)

Para compilar el archivo JAR y ensamblar dependencias desde la fuente, ejecuta los siguientes comandos:

  1. Clona el repositorio:

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

  2. Compila el paquete:

    mvn package -P assembly

El proceso de compilación crea los objetos binarios en la carpeta target/pgadapter.

Usa en un proceso de Java

Agrega google-cloud-spanner-pgadapter como dependencia a tu proyecto.

Maven

Si usas Maven, agrega la siguiente dependencia a tu archivo pom.xml:

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

¿Qué sigue?