Obtenir PGAdapter

Ce document explique comment obtenir le binaire PGAdapter. Utilisez PGAdapter avec des bases de données utilisant le dialecte PostgreSQL.

Exécutez PGAdapter dans un conteneur Docker, en tant que processus autonome ou en cours de traitement avec une application Java.

Exécuter dans un conteneur Docker

Exécutez PGAdapter dans un conteneur Docker à l'aide de l'une des options suivantes :

Image standard

Pour obtenir la dernière version de l'image standard, exécutez la commande suivante :

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

Pour obtenir une version précédente, ajoutez la version en tant que tag :

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

Image Distroless

Nous publions également une image Docker Distroless sous le tag gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless. Cette image exécute PGAdapter en tant qu'utilisateur non racine.

Pour extraire l'image Distroless, exécutez la commande suivante :

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

Exécuter en tant que processus autonome

Exécutez PGAdapter en tant que processus autonome dans le JVM en obtenant le fichier JAR à l'aide de l'une des options suivantes :

JAR prédéfini (dernière version)

Pour télécharger le dernier fichier JAR et les dépendances, exécutez la commande suivante :

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

JAR prédéfini (version spécifique)

Pour télécharger une version spécifique du fichier JAR, définissez la version lors du téléchargement.

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

JAR créé localement (à partir de la source)

Pour créer le fichier JAR et assembler les dépendances à partir de la source, exécutez les commandes suivantes :

  1. Clonez le dépôt :

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

  2. Créez le package :

    mvn package -P assembly

Le processus de compilation crée les binaires dans le dossier target/pgadapter.

Utiliser dans un processus Java

Ajoutez google-cloud-spanner-pgadapter en tant que dépendance à votre projet.

Maven

Si vous utilisez Maven, ajoutez la dépendance suivante à votre fichier pom.xml :

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

Étape suivante