文档中心
MogDBMogDB StackUqbar
生态工具
v3.0
文档目录
文档:v3.0
支持的版本:
其他版本:

oracle_fdw

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

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

编译oracle_fdw

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

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

安装好开发包后,就可以开始编译oracle_fdw了。编译时需要在执行configure时,加入--enable-oracle-fdw选项。后续按照正常的MogDB编译方式编译即可。

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

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

使用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等)。

  • 对外表做正常的操作,如INSERTUPDATEDELETESELECTEXPLAINANALYZECOPY等。

  • 删除外表:DROP FOREIGN TABLE

  • 删除用户映射:DROP USER MAPPING

  • 删除服务器对象:DROP SERVER

  • 删除扩展:DROP EXTENSION oracle_fdw

常见问题

  • 在MogDB上建立外表时,不会在Oracle数据库中同步建表,需要自行在Oracle数据库中建表。
  • 执行CREATE USER MAPPING时使用的Oracle用户需要有远程连接Oracle数据库及对表相关操作的权限。使用外表前,可以在MogDB 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权限。

注意事项

  • 两个Oracle外表间的SELECT JOIN不支持下推到Oracle server执行,会被分成两条SQL语句传递到Oracle执行,然后在MogDB处汇总处理结果。
  • 不支持IMPORT FOREIGN SCHEMA语法。
  • 不支持对外表进行CREATE TRIGGER操作。
Copyright © 2009-2022 www.enmotech.com All rights reserved.