更新时间:2026-10-21 GMT+08:00
分享

ALTER FOREIGN DATA WRAPPER

功能描述

修改外部数据封装的属性。

注意事项

  • 只有初始用户和系统管理员用户能够修改外部数据封装。
  • 只有在support_extended_features=on时才能够成功执行ALTER语句。

语法格式

设置外部数据封装属性
ALTER FOREIGN DATA WRAPPER name
[ HANDLER handler_function | NO HANDLER ]
[ VALIDATOR validator_function | NO VALIDATOR ]
[ OPTIONS ( { [ ADD | SET | DROP ] option ['value'] } [, ... ]) ];

参数说明

  • name

    已有外部数据封装的名称。

  • HANDLER handler_function

    为外部数据封装指定一个新的处理函数。

  • NO HANDLER

    用于指定外部数据封装不再拥有处理函数。

    使用外部数据封装但没有handler的外表不能访问。

  • VALIDATOR validator_function

    为外部数据封装指定一个新的验证函数。

    根据新的验证器,外部数据封装器或依赖的服务器、用户映射或外部表的已经存在的选项是有可能是无效的。用户在使用外部数据封装之前需要保证这些选项是正确的。不过,ALTER FOREIGN DATA WRAPPER命令中指定的任何选项都将使用新的验证函数检查。

  • NO VALIDATOR

    用于指定外部数据封装不再拥有验证函数。

  • OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] )

    修改外部数据封装的选项,选项名需满足唯一约束。ADD、SET和DROP为指定执行的操作,如果未指定,默认为ADD。使用外部数据封装验证函数时,名称和取值也会被验证。

示例

--创建一个外部数据封装dbi。
gaussdb=# CREATE FOREIGN DATA WRAPPER dbi OPTIONS (bar 'true');

--修改一个外部数据封装dbi,增加选项foo,删除bar。
gaussdb=# ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP 'bar');

--修改外部数据封装dbi验证器为file_fdw_validator。
gaussdb=# ALTER FOREIGN DATA WRAPPER dbi VALIDATOR file_fdw_validator;

--修改外部数据封装dbi处理函数为file_fdw_handler。
gaussdb=# ALTER FOREIGN DATA WRAPPER dbi HANDLER file_fdw_handler;

--删除外部数据封装dbi。(前置条件:需确认GUC参数support_extended_features=on)
gaussdb=# DROP FOREIGN DATA WRAPPER dbi;

相关文档