为 AlloyDB Omni 安装 Orafce

选择文档版本:

AlloyDB Omni 不包含 Orafce 扩展程序,但您可以按照本页面上的说明将其手动添加到现有的 AlloyDB Omni 安装中,以便提供来自 Oracle 数据库的其他函数和运算符。

准备工作

确保您已在系统上安装 AlloyDB Omni

单个服务器

将 Orafce 添加到 AlloyDB Omni 安装

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

  1. 查找已安装的 AlloyDB Omni 版本标签:
    docker run --rm -it  google/alloydbomni cat VERSION.txt

    输出类似于以下内容:

    AlloyDB Omni version: 15.5.3
    

    记下 AlloyDB Omni 版本号;您在下一步中需要用到它。

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

    VERSION 替换为来自上一步的完整数据库服务器版本,例如 15.5.3

  3. 创建一个包含 Orafce 的新 AlloyDB Omni 容器:

    Linux

      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 google/alloydbomni:${OMNI_VERSION}
    
      COPY --from=postgres /usr/lib/postgresql/15/lib/orafce.so /usr/lib/postgresql/15/lib/orafce.so
      COPY --from=postgres /usr/share/postgresql/15/extension/orafce* /usr/lib/postgresql/15/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 google/alloydbomni-with-orafce:$OMNI_VERSION .
      

    macOS

      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 google/alloydbomni:${OMNI_VERSION}
    
      COPY --from=postgres /usr/lib/postgresql/15/lib/orafce.so /usr/lib/postgresql/15/lib/orafce.so
      COPY --from=postgres /usr/share/postgresql/15/extension/orafce* /usr/lib/postgresql/15/share/extension/
    
      COPY --from=postgres /usr/lib/aarch64-linux-gnu/ /usr/lib/aarch64-linux-gnu/
      COPY --from=postgres /lib/aarch64-linux-gnu/ /lib/aarch64-linux-gnu/
      EOF
      cd ~/alloydb-omni-orafce
      sudo docker build --build-arg OMNI_VERSION=$OMNI_VERSION --tag google/alloydbomni-with-orafce:$OMNI_VERSION .
      

  4. 创建一个名为 my-omni-orafce 的 AlloyDB Omni 容器:
    docker run --name my-omni-orafce  -e POSTGRES_PASSWORD=NEW_PASSWORD  -d google/alloydbomni-with-orafce:OMNI_VERSION
  5. 使用 Orafce 扩展程序连接到您的数据库:
    docker exec -it my-omni-orafce psql -h localhost -U postgres
    
  6. 启用 Orafce:
    CREATE EXTENSION IF NOT EXISTS ORAFCE;
  7. 确认 Orafce 已安装并已启用:
    SELECT oracle.sysdate();
    输出类似于以下内容:
    postgres=# SELECT oracle.sysdate();
         sysdate
    ---------------------
    2024-06-10 16:36:30
    (1 row)