PostgreSQL 教程

Appearance

CREATE FOREIGN DATA WRAPPER ​

CREATE FOREIGN DATA WRAPPER — 定义一个新的外数据包装器

概要 ​

CREATE FOREIGN DATA WRAPPER name
    [ HANDLER handler_function | NO HANDLER ]
    [ VALIDATOR validator_function | NO VALIDATOR ]
    [ OPTIONS ( option 'value' [, ... ] ) ]

描述 ​

CREATE FOREIGN DATA WRAPPER创建一个新的外数据包装器。定义外数据包装器的用户将成为其所有者。

外数据包装器名称在数据库中必须是唯一的。

只有超级用户才能创建外数据包装器。

参数 ​

name

要创建的外数据包装器的名称。

HANDLER handler_function

handler_function 是先前注册的函数的名称，该函数将被调用以检索外表的执行函数。该处理函数不得采用任何参数，并且其返回类型必须是 fdw_handler。

可以创建一个没有处理函数的外数据包装器，但使用此类包装器的外表只能声明，而不能访问。

VALIDATOR validator_function

validator_function 是先前注册的函数的名称，该函数将被调用以检查提供给外数据包装器的通用选项，以及使用外数据包装器的外部服务器、用户映射和外表的选项。如果没有指定验证器函数或 NO VALIDATOR，则在创建时不会检查选项。（外数据包装器可能会在运行时忽略或拒绝无效的选项规范，具体取决于实现。）验证器函数必须采用两个参数：一个类型为 text[]，其中将包含存储在系统目录中的选项数组，另一个类型为 oid，其中将包含包含选项的系统目录的 OID。返回类型将被忽略；函数应使用 ereport(ERROR) 函数报告无效的选项。

选项 ( 选项 '值' [, ... ] )

此子句为新的外部数据封装程序指定选项。允许的选项名称和值特定于每个外部数据封装程序，并使用外部数据封装程序的验证器函数进行验证。选项名称必须唯一。

说明 ​

PostgreSQL的外部数据功能仍在积极开发中。查询优化是原始的（并且大部分也留给了封装程序）。因此，未来性能改进有相当大的空间。

示例 ​

创建一个无用的外部数据封装程序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');

兼容性 ​

CREATE FOREIGN DATA WRAPPER符合 ISO/IEC 9075-9 (SQL/MED)，但HANDLER和VALIDATOR子句是扩展，标准子句LIBRARY和LANGUAGE未在PostgreSQL中实现。

但是，请注意，SQL/MED 功能作为一个整体尚未符合标准。

另请参见 ​

ALTER FOREIGN DATA WRAPPER、DROP FOREIGN DATA WRAPPER、CREATE SERVER、CREATE USER MAPPING、CREATE FOREIGN TABLE