הורדת PGAdapter

במאמר הזה מוסבר איך להוריד את הקובץ הבינארי של PGAdapter. משתמשים ב-PGAdapter עם מסדי נתונים בניב PostgreSQL.

מריצים את PGAdapter בקונטיינר של Docker, כתהליך עצמאי או כתהליך באפליקציית Java.

הרצה בקונטיינר של Docker

מריצים את PGAdapter בקונטיינר של Docker באמצעות אחת מהאפשרויות הבאות:

תמונה רגילה

כדי לקבל את הגרסה העדכנית של קובץ האימג' הרגיל, מריצים את הפקודה הבאה:

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

כדי לקבל גרסה קודמת, מוסיפים את הגרסה כתג:

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

תמונת Distroless

אנחנו מפרסמים גם קובץ אימג' של Docker ללא הפצה בתג gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless. התמונה הזו מריצה את PGAdapter כמשתמש שאינו Root.

כדי למשוך את קובץ האימג' ללא הפצה, מריצים את הפקודה הבאה:

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

הפעלה כתהליך עצמאי

מריצים את PGAdapter כתהליך עצמאי ב-JVM על ידי קבלת קובץ ה-JAR באמצעות אחת מהאפשרויות הבאות:

קובץ JAR שנבנה מראש (הגרסה העדכנית)

כדי להוריד את קובץ ה-JAR העדכני ביותר ואת יחסי התלות, מריצים את הפקודה הבאה:

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

קובץ JAR מוגדר מראש (גרסה ספציפית)

כדי להוריד גרסה ספציפית של קובץ ה-JAR, צריך להגדיר את הגרסה כשמורידים אותו.

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

קובץ JAR שנוצר באופן מקומי (מהמקור)

כדי ליצור את קובץ ה-JAR ולאסוף את יחסי התלות מהמקור, מריצים את הפקודות הבאות:

  1. משכפלים את המאגר:

    git clone https://github.com/GoogleCloudPlatform/pgadapter.git
    
  2. יוצרים את החבילה:

    mvn package -P assembly
    

תהליך ה-build יוצר את הקבצים הבינאריים בתיקייה target/pgadapter.

שימוש בתהליך Java

מוסיפים את google-cloud-spanner-pgadapter כתלות לפרויקט.

Maven

אם אתם משתמשים ב-Maven, הוסיפו את התלות הבאה לקובץ pom.xml:

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

שימוש ב-Spanner PG Connector (spgc)

כדי להריץ כלי שורת פקודה של PostgreSQL כמו psql או pg_dump בלי להתקין את Java או Docker, משתמשים ב-spanner-pg-connector (עם הכינוי spgc). spgc כולל את PGAdapter וסביבת זמן ריצה מינימלית של Java. הוראות להתקנה ולשימוש מפורטות במאמר הפעלת PGAdapter.

המאמרים הבאים