安裝 AlloyDB Omni 適用的 Orafce

選取文件版本：

AlloyDB Omni 不含 Orafce 擴充功能，但您可以按照本頁的說明，手動將其新增至現有的 AlloyDB Omni 安裝項目。

事前準備

確認符合下列系統需求：

在 AlloyDB Omni 安裝中新增 Orafce

如要在 AlloyDB Omni 安裝中新增 Orafce 擴充功能，請按照下列步驟操作：

  1. 找出已安裝的 AlloyDB Omni 版本標籤： 
    sudo alloydb version

    輸出結果會與下列內容相似：

    AlloyDB Omni CLI version: 1.0
AlloyDB Omni database server version: 15.2.0

    記下資料庫伺服器版本號碼，下一個步驟會用到。

  2. 設定 OMNI_VERSION 環境變數： 
    OMNI_VERSION=VERSION

    將 VERSION 替換為上一個步驟中的完整資料庫伺服器版本，例如 15.2.0。

  3. 建立包含 Orafce 的新 AlloyDB Omni 容器： 
    mkdir ~/alloydb-omni-orafce
tee -a ~/alloydb-omni-orafce/Dockerfile << EOF
ARG OMNI_VERSION

FROM postgres:15-bookworm as postgres

RUN apt-get update && \
        apt-get install -y --no-install-recommends \
        postgresql-15-orafce && \
        apt-get purge -y --auto-remove && \
        rm -rf /var/lib/apt/lists/*

FROM gcr.io/alloydb-omni/pg-service:${OMNI_VERSION}

COPY --from=postgres /usr/lib/postgresql/15/lib/orafce.so /lib/orafce.so
COPY --from=postgres /usr/share/postgresql/15/extension/orafce* /share/extension/

COPY --from=postgres /usr/lib/x86_64-linux-gnu/ /usr/lib/x86_64-linux-gnu/
COPY --from=postgres /lib/x86_64-linux-gnu/ /lib/x86_64-linux-gnu/
EOF

cd ~/alloydb-omni-orafce

sudo docker build --build-arg OMNI_VERSION=$OMNI_VERSION --tag gcr.io/alloydb-omni/pg-service-with-orafce:$OMNI_VERSION .
  4. 停止資料庫伺服器： 
    sudo alloydb database-server stop
  5. 在文字編輯器中開啟 /var/alloydb/config/dataplane.conf。
  6. 修改定義 PG_IMAGE 變數的行，使其參照您在上一個步驟中建構的容器： 
    PG_IMAGE=gcr.io/alloydb-omni/pg-service-with-orafce
  7. 啟動 AlloyDB Omni： 
    sudo alloydb database-server start
  8. 連線至資料庫： 
    sudo docker exec -it pg-service psql -h localhost -U postgres
  9. 啟用 Orafce： 
    CREATE EXTENSION IF NOT EXISTS ORAFCE;
  10. 確認已安裝並啟用 Orafce： 
    SELECT oracle.sysdate();