为 AlloyDB Omni 安装 orafce

选择文档版本：

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

准备工作

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

将 orafce 添加到 AlloyDB Omni 安装

如需将 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: 15.7.0

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

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

    将 VERSION 替换为来自上一步的完整数据库服务器版本，例如 15.7.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-15-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-15-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. 创建一个名为 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)