Obtén PGAdapter

En este documento, se explica cómo obtener el objeto binario de PGAdapter. Usa PGAdapter con bases de datos de 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 sin distribución 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 sin distribución, ejecuta el siguiente comando:

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

Ejecutar como un proceso independiente

Ejecuta PGAdapter como un proceso independiente en la JVM obteniendo el archivo JAR con una de las siguientes opciones:

JAR compilado previamente (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 compilado previamente (versión específica)

Para descargar una versión específica del archivo JAR, establece la versión cuando lo 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 las 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.56.4</version>
</dependency>

Usa el conector de PG de Spanner (spgc)

Para ejecutar herramientas de línea de comandos de PostgreSQL, como psql o pg_dump, sin instalar Java ni Docker, usa spanner-pg-connector (con el alias spgc). spgc incluye PGAdapter y un entorno de ejecución de Java mínimo. Para obtener instrucciones de instalación y uso, consulta Inicia PGAdapter.

¿Qué sigue?