openGauss学习笔记-93 openGauss 数据库管理-访问外部数据库-oracle_fdw

openGauss的fdw实现的功能是各个openGauss数据库及远程服务器（包括数据库、文件系统）之间的跨库操作。目前支持的远程服务器类型包括Oracle、MySQL（MariaDB）、openGauss（postgres_fdw）、file_fdw 、dblink。

oracle_fdw（foreign data wrapper for oracle）用于Oracle的外部数据包装器，是一款开源插件。openGauss基于开源的oracle_fdw Release 2.2.0 版本进行开发适配。

编译和使用oracle_fdw需要环境上包含Oracle的开发包，所以openGauss默认不编译oracle_fdw，下面依次介绍如何编译和使用oracle_fdw。

93.1 编译oracle_fdw

编译oracle_fdw需要安装Oracle的开发库和头文件。

选择合适的运行环境和版本，下载Basic Package和SDK Package并安装。另外SQLPlus Package是Oracle的客户端工具，也可以根据需要安装，用于连接Oracle Server进行测试。

安装好开发包后，就可以开始编译oracle_fdw了。编译时需要在执行configure时，加入 –enable-oracle-fdw 选项。后续按照正常的openGauss编译方式编译即可。（openGauss的编译参考 软件安装编译 ）

编译完成后，编译产物为 oracle_fdw.so，位于安装目录的 **lib/postgresql/**下。oracle_fdw相关的sql文件和control文件，位于安装目录的 **share/postgresql/Extension/**下。

如果编译安装时，没有加入 –enable-oracle-fdw 选项，可以在openGauss安装完成后，再次编译oracle_fdw，然后手动将编译产物 oracle_fdw.so放到对应的安装目录 lib/postgresql/ ，将 oracle_fdw–1.0–1.1.sql、oracle_fdw–1.1.sql、oracle_fdw.control放到对应的安装目录 **share/postgresql/Extension/**即可。

93.2 使用oracle_fdw

• 使用oracle_fdw需要连接Oracle，Oracle server请自行安装。

• 加载oracle_fdw扩展：CREATE Extension oracle_fdw

• 创建服务器对象：CREATE SERVER

• 创建用户映射：CREATE USER MAPPING

• 创建外表：CREATE FOREIGN TABLE

  外表的表结构需要与Oracle数据库中的表结构保持一致。注意Oracle server侧的表的第一个字段必须具有唯一性约束（如PRIMARY KEY、UNIQUE等）。

• 对外表做正常的操作，如INSERT、UPDATE、DELETE、SELECT、EXPLAIN、ANALYZE、COPY等。

• 删除外表：DROP FOREIGN TABLE

• 删除用户映射：DROP USER MAPPING

• 删除服务器对象：DROP SERVER

• 删除扩展：DROP Extension oracle_fdw

93.3 常见问题

• 在openGauss上建立外表时，不会在Oracle数据库中同步建表，需要自行在Oracle数据库中建表。
• 执行CREATE USER MAPPING时使用的Oracle用户需要有远程连接Oracle数据库及对表相关操作的权限。使用外表前，可以在openGauss server所在的机器上，使用Oracle的客户端，使用对应的用户名密码确认能否成功连接Oracle并进行操作。
• 执行**CREATE Extension oracle_fdw;**时，出现libclntsh.so: cannot open shared object file: No such file or directory。原因是Oracle的开发库libclntsh.so不在系统的相关路径中，可以先找到libclntsh.so的具体路径，然后将该so文件所在的文件夹加到 /etc/ld.so.conf 中。比如libclntsh.so的路径为 /usr/lib/oracle/11.2/client64/lib/libclntsh.so.11.1 ，那么就将该文件的路径 /usr/lib/oracle/11.2/client64/lib/ 加到 /etc/ld.so.conf文件末尾。然后执行ldconfig使修改生效即可。注意此操作需要root权限。

93.4 注意事项

• 两个Oracle外表间的SELECT JOIN不支持下推到Oracle server执行，会被分成两条SQL语句传递到Oracle执行，然后在openGauss处汇总处理结果。
• 不支持IMPORT FOREIGN SCHEMA语法。
• 不支持对外表进行CREATE TRIGGER操作。

👍 点赞，你的认可是我创作的动力！

⭐️ 收藏，你的青睐是我努力的方向！

✏️ 评论，你的意见是我进步的财富！