postgres_fdw

postgres_fdw是一款开源插件，其代码随PostgreSQL源码一同发布。MogDB基于开源的PostgreSQL 9.4.26版本中的postgres_fdw源码https://ftp.postgresql.org/pub/source/v9.4.26/postgresql-9.4.26.tar.gz进行开发适配。postgres_fdw以插件方式提供。

说明：当前postgres_fdw仅支持MogDB连接MogDB，不支持MogDB连接PostgreSQL。

安装postgres_fdw

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

2. 解压插件包，例如：

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

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

   cd postgres_fdw/
   make install

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

   MogDB=# create extension postgres_fdw;
   CREATE EXTENSION

使用postgres_fdw

• 加载postgres_fdw扩展：CREATE EXTENSION postgres_fdw;
• 创建服务器对象：CREATE SERVER
• 创建用户映射：CREATE USER MAPPING
• 创建外表：CREATE FOREIGN TABLE外表的表结构需要与远端MogDB侧的表结构保持一致。
• 对外表做正常的操作，如INSERT、UPDATE、DELETE、SELECT、EXPLAIN、ANALYZE、COPY等。
• 删除外表：DROP FOREIGN TABLE
• 删除用户映射：DROP USER MAPPING
• 删除服务器对象：DROP SERVER
• 删除扩展：DROP EXTENSION postgres_fdw;

常见问题

• 在MogDB上建立外表时，不会同步在远端的MogDB上建表，需要自己利用客户端连接远端MogDB建表。
• 执行CREATE USER MAPPING时使用的MogDB用户需要有远程连接MogDB及对表相关操作的权限。使用外表前，可以在本地机器上，使用gsql的客户端，使用对应的用户名密码确认能否成功连接远端MogDB并进行操作。

注意事项

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