更新时间: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;
父主题: A