CREATE FOREIGN DATA WRAPPER

定义一个新的外部数据包装器。

概要

CREATE FOREIGN DATA WRAPPER name
    [ HANDLER handler_function | NO HANDLER ]
    [ VALIDATOR validator_function | NO VALIDATOR ]
    [ OPTIONS ( [ mpp_execute { 'master' | 'any' | 'all segments' } [, ] ] option 'value' [, ... ] ) ]

描述

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

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

参数

name

  • 要创建的外部数据包装器的名称。 该名称在数据库中必须唯一。

HANDLER handler_function

  • MatrixDB数据库调用以检索外部表的执行函数的先前注册函数的名称。 hander_function必须不带任何参数,其返回类型必须是fdw_handler。
    可以创建没有处理程序函数的外部数据包装器,但是只能使用此类包装器声明而不访问外部表。

VALIDATOR validator_function

  • MatrixDB数据库调用以检查提供给外部数据包装程序的选项的先前注册函数的名称。 此函数还检查使用外部数据包装器的外部服务器,用户映射和外部表的选项。 如果未指定验证器函数或指定NO VALIDATOR,则MatrixDB数据库在创建时不会检查选项。 (根据实现的不同,外部数据包装程序可能会在运行时忽略或拒绝无效的选项。)
    validator_function必须带有两个参数:一个是text[]类型, 它包含存储在系统catalog中的选项数组,另一个是oid类型,它标识包含选项的系统catalog的OID。
    返回类型将被忽略;validator_function应该使用ereport(ERROR)函数报告无效的选项。

OPTIONS ( option 'value' [, ... ] )

  • 新的外部数据包装程序的选项。 选项名称必须唯一。 选项名称和值是特定于外部数据包装器的,并使用外部数据包装器的validator_function进行了验证。

mpp_execute { 'master' | 'any' | 'all segments' }

  • 一个选项,用于标识外部数据包装器从其请求数据的主机:
    • master(默认)— 从master主机请求数据。
    • any — 向master主机或任一segment请求数据,具体取决于哪条路径的成本更低。
    • all segments — 从所有segment请求数据。 要支持此选项值,外部数据包装器必须具有将segment与数据匹配的策略。
  • 可以在多个命令中指定mpp_execute选项: CREATE FOREIGN TABLE,CREATE SERVER和CREATE FOREIGN DATA WRAPPER。 外部表设置优先于外部服务器设置,然后是外部数据包装器设置。

注解

外部数据包装器功能仍在开发中。 查询的优化是原始的(大部分留给包装器)。

示例

创建一个无用的外部数据包装器,命名为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), 但LIBRARY和VALIDATOR子句是扩展是例外, 而MatrixDB数据库中未实现标准子句LIBRARY和LANGUAGE。

但是请注意,整个SQL/MED函数尚未符合要求。

另见

ALTER FOREIGN DATA WRAPPER , DROP FOREIGN DATA WRAPPER