取得 PGAdapter

本文說明如何取得 PGAdapter 二進位檔。搭配使用 PGAdapter 與 PostgreSQL 方言資料庫。

在 Docker 容器中執行 PGAdapter,做為獨立程序,或與 Java 應用程式一起執行。

在 Docker 容器中執行

使用下列其中一種選項,在 Docker 容器中執行 PGAdapter:

標準圖片

如要取得最新版本標準映像檔,請執行下列指令:

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

如要取得舊版本,請將版本附加為標記:

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

Distroless 映像檔

我們也會在 gcr.io/cloud-spanner-pg-adapter/pgadapter-distroless 標記下發布無發行版 Docker 映像檔。這個映像檔會以非超級使用者的身分執行 PGAdapter。

如要提取無發行版映像檔,請執行下列指令:

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

以獨立程序執行

使用下列任一選項取得 JAR 檔案,在 JVM 中以獨立程序執行 PGAdapter:

預先建構的 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
    

建構程序會在 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 連接器 (spgc)

如要執行 PostgreSQL 指令列工具 (例如 psql 或 pg_dump),而不安裝 Java 或 Docker,請使用 spanner-pg-connector (別名為 spgc)。spgc 包含 PGAdapter 和最小 Java 執行階段。如需安裝和使用操作說明,請參閱「啟動 PGAdapter」。

後續步驟