安装适用于 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. 使用 AlloyDB Omni 创建一个名为 my-omni-orafce 的新容器:
    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)