创建外部数据包装器
创建外部数据包装器—定义新的外部数据包装器
Synopsis
CREATE FOREIGN DATA WRAPPER name
[ HANDLER handler_function | NO HANDLER ]
[ VALIDATOR validator_function | NO VALIDATOR ]
[ OPTIONS ( option 'value' [, ... ] ) ]
Description
CREATE FOREIGN DATA WRAPPER创建一个新的外部数据包装器。定义外部数据包装器的用户将成为其所有者。
外部数据包装器名称在数据库中必须唯一。
只有超级用户才能创建外部数据包装器。
Parameters
name- 要创建的外部数据包装器的名称。
HANDLER handler_function-
handler_function*是先前注册的函数的名称，将调用该函数来检索外部表的执行函数。处理函数必须不带任何参数，其返回类型必须为fdw_handler。
-
可以创建没有处理程序功能的外部数据包装器，但是只能声明而不访问使用这种包装器的外部表。
VALIDATOR validator_function-
validator_function*是先前注册的函数的名称，将调用该函数来检查提供给外部数据包装程序的通用选项，以及使用外部数据包装程序的外部服务器，用户 Map 和外部表的选项。如果未指定验证器功能或NO VALIDATOR，则在创建时将不会检查选项。 (根据实现的不同，外部数据包装程序可能会在运行时忽略或拒绝无效的选项说明.)验证器函数必须采用两个参数：text[]类型之一，它将包含存储在系统目录中的选项数组，和oid类型之一，它将是包含选项的系统目录的 OID。返回类型将被忽略；该函数应使用ereport(ERROR)函数报告无效选项。
-
OPTIONS ( option 'value' [, ... ] )- 此子句为新的外部数据包装程序指定选项。允许的选项名称和值特定于每个外部数据包装器，并使用外部数据包装器的验证器功能进行验证。选项名称必须唯一。
Notes
PostgreSQL 的外部数据功能仍在积极开发中。查询的优化是原始的(而且大多数情况也留给包装器)。因此，有很大的空间可用于将来的性能改进。
Examples
创建一个无用的外部数据包装器dummy：
CREATE FOREIGN DATA WRAPPER dummy;
使用处理程序函数file_fdw_handler创建外部数据包装器file：
CREATE FOREIGN DATA WRAPPER file HANDLER file_fdw_handler;
创建带有某些选项的外部数据包装器mywrapper：
CREATE FOREIGN DATA WRAPPER mywrapper
OPTIONS (debug 'true');
Compatibility
CREATE FOREIGN DATA WRAPPER符合 ISO/IEC 9075-9(SQL/MED)，但HANDLER和VALIDATOR子句是 extensions，而标准子句LIBRARY和LANGUAGE不在 PostgreSQL 中实现。
但是请注意，整个 SQL/MED 功能尚未符合要求。