Ottenere PGAdapter

Questo documento spiega come ottenere il file binario di PGAdapter. Utilizza PGAdapter con i database con dialetto PostgreSQL.

Esegui PGAdapter in un container Docker, come processo autonomo o in-process con un'applicazione Java.

Esegui in un container Docker

Esegui PGAdapter in un container Docker utilizzando una delle seguenti opzioni:

Immagine standard

Per ottenere l'ultima versione dell'immagine standard, esegui questo comando:

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

Per ottenere una versione precedente, aggiungi la versione come tag:

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

Immagine distroless

Pubblichiamo anche un'immagine Docker distroless con il tag gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless. Questa immagine esegue PGAdapter come utente non root.

Per eseguire il pull dell'immagine distroless, esegui questo comando:

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

Esegui come processo autonomo

Esegui PGAdapter come processo autonomo nella JVM recuperando il file JAR utilizzando una delle seguenti opzioni:

JAR predefinito (ultima versione)

Per scaricare il file JAR e le dipendenze più recenti, esegui questo comando:

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

JAR predefinito (versione specifica)

Per scaricare una versione specifica del file JAR, imposta la versione quando lo scarichi.

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

JAR creato localmente (dal codice sorgente)

Per creare il file JAR e assemblare le dipendenze dall'origine, esegui questi comandi:

  1. Clona il repository:

    git clone https://github.com/GoogleCloudPlatform/pgadapter.git
    
  2. Crea il pacchetto:

    mvn package -P assembly
    

Il processo di compilazione crea i file binari nella cartella target/pgadapter.

Utilizzo in un processo Java

Aggiungi google-cloud-spanner-pgadapter come dipendenza al tuo progetto.

Maven

Se utilizzi Maven, aggiungi la seguente dipendenza al file pom.xml:

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

Utilizza il connettore Spanner PG (spgc)

Per eseguire strumenti a riga di comando PostgreSQL come psql o pg_dump senza installare Java o Docker, utilizza spanner-pg-connector (con alias spgc). spgc raggruppa PGAdapter e un runtime Java minimo. Per istruzioni sull'installazione e sull'utilizzo, consulta Avvia PGAdapter.

Passaggi successivi