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

postgres_fdw默认参与编译，登录数据库后通过CREATE EXTENSION postgres_fdw;语句创建插件即可使用。

您也可以通过以下步骤单独安装postgres_fdw。

解压插件包，例如：

tar -xzvf postgres_fdw-1.0-5.0.0-01-Kylin-x86_64.tar.gz

使用数据库初始用户omm进入插件所在目录下，执行make install命令。
```
cd postgres_fdw/
make install
```
连接到数据库，执行CREATE EXTENSION postgres_fdw;插件即可使用。
```
MogDB=# CREATE EXTENSION postgres_fdw;
CREATE EXTENSION
```

加载postgres_fdw扩展：CREATE EXTENSION postgres_fdw;
创建服务器对象：CREATE SERVER
创建用户映射：CREATE USER MAPPING
直接使用@符号加server_name对外部表进行DML操作，即<table_name>@<server_name>。

说明：也可以先创建外表（CREATE FOREIGN TABLE），再对外表做正常的操作，如INSERT、UPDATE、DELETE、SELECT、EXPLAIN、ANALYZE、COPY等。外表的表结构需要与远端MogDB侧的表结构保持一致。
删除外表：DROP FOREIGN TABLE
删除用户映射：DROP USER MAPPING
删除服务器对象：DROP SERVER
删除扩展：DROP EXTENSION postgres_fdw;
查看REMOTE SQL PLAN：开启GUC参数show_fdw_remote_plan，可以在explain时追加打印remote sql的计划，对remote sql的explain会继承explain语句的verbose、costs选项。

支持的下推成分：

不支持的下推成分：

在MogDB上建立外表时，不会同步在远端的MogDB上建表，需要自己利用客户端连接远端MogDB建表。
外表并不会区分远端表的具体表类型，不会检查表结构等是否对应，甚至连是否存在都不会检查。需要用户自己维护与保证这些属性关系。
执行CREATE USER MAPPING时使用的MogDB用户需要有远程连接MogDB及对表相关操作的权限。使用外表前，可以在本地机器上，使用gsql的客户端，使用对应的用户名密码确认能否成功连接远端MogDB并进行操作。