为 AlloyDB Omni 安装 orafce

AlloyDB Omni 不包含 orafce 扩展程序，但您可以按照本页中的说明将其手动添加到现有的 AlloyDB Omni 安装。orafce 扩展程序提供了一些函数和运算符，可模拟 Oracle 数据库中的部分函数和软件包，从而简化了将应用从 Oracle 迁移到与 PostgreSQL 兼容的数据库（例如 AlloyDB Omni）的过程。

准备工作

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

向 AlloyDB Omni 安装中添加 orafce

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

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

   Docker

   docker run --rm -it  google/alloydbomni cat VERSION.txt

   Podman

   podman run --rm -it  google/alloydbomni cat VERSION.txt

   输出类似于以下内容：

   AlloyDB Omni version: Omniween
   

   记下 AlloyDB Omni 版本号，您需要在下一步中使用此版本号。

2. 设置 OMNI_VERSION 环境变量：

   OMNI_VERSION=VERSION

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

3. 创建一个包含 orafce 的新 AlloyDB Omni 容器：

   Linux

         mkdir ~/alloydb-omni-orafce
         tee -a ~/alloydb-omni-orafce/Dockerfile << EOF
         ARG OMNI_VERSION
         FROM google/alloydbomni:${OMNI_VERSION}
         RUN apt-get update && \
               apt-get install -y --no-install-recommends postgresql-16-orafce && \
               apt-get purge -y --auto-remove && \
               rm -rf /var/lib/apt/lists/*
         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 google/alloydbomni:${OMNI_VERSION}
         RUN apt-get update && \
               apt-get install -y --no-install-recommends postgresql-16-orafce && \
               apt-get purge -y --auto-remove && \
               rm -rf /var/lib/apt/lists/*
         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)