为 AlloyDB Omni 安装 Orafce

选择文档版本：

AlloyDB Omni 不包含 Orafce 扩展程序，但您可以按照本页面上的说明将其手动添加到现有的 AlloyDB Omni 安装中。

准备工作

请确保您满足以下系统要求：

将 Orafce 添加到 AlloyDB Omni 安装

如需将 Orafce 扩展程序添加到 AlloyDB Omni 安装，请按照以下步骤操作：

  1. 查找已安装的 AlloyDB Omni 版本标签： 
    sudo alloydb version

    输出类似于以下内容：

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

    记下数据库服务器版本号；您在下一步中需要用到它。

  2. 设置 OMNI_VERSION 环境变量： 
    OMNI_VERSION=VERSION

    将 VERSION 替换为来自上一步的完整数据库服务器版本，例如 15.5.2。

  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();