oracle_fdw

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

安装oracle_fdw

1. 访问MogDB下载页面，下载所需版本的oracle_fdw插件。

2. 解压插件包，例如：

   tar -xzvf oracle_fdw-1.0-3.1.0-01-CentOS-x86_64.tar.gz

3. 进入插件所在目录下，执行make install命令。

   cd oracle_fdw/
   make install

4. 连接到数据库，执行create extension oracle_fdw;插件即可使用。

   MogDB=# create extension oracle_fdw;
   CREATE 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等）。

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

• 删除外表：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操作。