On this page
更改外部数据包装器
ALTER FOREIGN DATA WRAPPER —更改外来数据包装器的定义
Synopsis
ALTER FOREIGN DATA WRAPPER name
[ HANDLER handler_function | NO HANDLER ]
[ VALIDATOR validator_function | NO VALIDATOR ]
[ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ]) ]
ALTER FOREIGN DATA WRAPPER name OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
ALTER FOREIGN DATA WRAPPER name RENAME TO new_name
Description
ALTER FOREIGN DATA WRAPPER更改外部数据包装器的定义。命令的第一种形式更改了外部数据包装器的支持功能或通用选项(至少需要一个子句)。第二种形式更改了外部数据包装器的所有者。
只有超级用户才能更改外部数据包装器。此外,只有超级用户才能拥有外部数据包装器。
Parameters
name- 现有外部数据包装器的名称。
HANDLER handler_function- 为外部数据包装器指定一个新的处理函数。
NO HANDLER- 这用于指定外部数据包装器不再具有处理程序功能。
请注意,不能访问使用没有处理程序的外部数据包装器的外部表。
VALIDATOR validator_function- 为外部数据包装器指定一个新的验证器函数。
请注意,根据新的验证器,外部数据包装程序或从属服务器,用户 Map 或外部表的预先存在的选项可能无效。 PostgreSQL 不检查这一点。在使用修改后的外部数据包装程序之前,用户需要确保这些选项正确。但是,将使用新的验证器来检查此ALTER FOREIGN DATA WRAPPER命令中指定的任何选项。
NO VALIDATOR- 这用于指定外部数据包装器不应再具有验证器功能。
OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] )- 更改外部数据包装器的选项。
ADD,SET和DROP指定要执行的动作。如果未明确指定任何操作,则假定ADD。选项名称必须唯一。还可以使用外部数据包装器的验证器功能(如果有)来验证名称和值。
- 更改外部数据包装器的选项。
new_owner- 外部数据包装程序的新所有者的用户名。
new_name- 外部数据包装器的新名称。
Examples
更改外部数据包装器dbi,添加选项foo,删除bar:
ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP 'bar');
将外部数据包装器dbi验证器更改为bob.myvalidator:
ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;
Compatibility
ALTER FOREIGN DATA WRAPPER符合 ISO/IEC 9075-9(SQL/MED),但HANDLER,VALIDATOR,OWNER TO和RENAME子句是 extensions。