PGAdapter herunterladen

In diesem Dokument wird erläutert, wie Sie die PGAdapter-Binärdatei erhalten. Verwenden Sie PGAdapter mit Datenbanken im PostgreSQL-Dialekt.

Sie können PGAdapter in einem Docker-Container, als eigenständigen Prozess oder als Verarbeitungsprozess mit einer Java-Anwendung ausführen.

In einem Docker-Container ausführen

Sie haben folgende Möglichkeiten, PGAdapter in einem Docker-Container auszuführen:

Standardbild

Führen Sie den folgenden Befehl aus, um die neueste Version des Standardbilds abzurufen:

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

Wenn Sie eine frühere Version abrufen möchten, hängen Sie die Version als Tag an:

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

Distroless-Image

Wir veröffentlichen auch ein Distroless-Docker-Image unter dem Tag gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless. Dieses Image führt PGAdapter als Nutzer ohne Root-Berechtigung aus.

Führen Sie den folgenden Befehl aus, um das Distroless-Image abzurufen:

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

Als eigenständigen Prozess ausführen

Sie können PGAdapter als eigenständigen Prozess in der JVM ausführen, indem Sie die JAR-Datei mit einer der folgenden Optionen abrufen:

Vorkompilierte JAR-Datei (neueste Version)

Führen Sie den folgenden Befehl aus, um die neueste JAR-Datei und die zugehörigen Abhängigkeiten herunterzuladen:

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

Vorkompilierte JAR-Datei (bestimmte Version)

Wenn Sie eine bestimmte Version der JAR-Datei herunterladen möchten, legen Sie die Version beim Herunterladen fest.

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

Lokal erstellte JAR-Datei (aus der Quelle)

Führen Sie die folgenden Befehle aus, um die JAR-Datei zu erstellen und Abhängigkeiten aus der Quelle zusammenzustellen:

  1. Klonen Sie das Repository:

    git clone https://github.com/GoogleCloudPlatform/pgadapter.git
    
  2. Erstellen Sie das Paket:

    mvn package -P assembly
    

Beim Build-Prozess werden die Binärdateien im Ordner target/pgadapter erstellt.

In einem Java-Prozess verwenden

Fügen Sie google-cloud-spanner-pgadapter als Abhängigkeit zu Ihrem Projekt hinzu.

Maven

Wenn Sie Maven verwenden, fügen Sie der Datei pom.xml die folgende Abhängigkeit hinzu:

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

Nächste Schritte