pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
ALTER FOREIGN DATA WRAPPER — 更改外部数据包装器的定义
ALTER FOREIGN DATA WRAPPERname[ HANDLERhandler_function| NO HANDLER ] [ VALIDATORvalidator_function| NO VALIDATOR ] [ CONNECTIONconnection_function| NO CONNECTION ] [ OPTIONS ( [ ADD | SET | DROP ]option['value'] [, ... ]) ] ALTER FOREIGN DATA WRAPPERnameOWNER TO {new_owner| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER FOREIGN DATA WRAPPERnameRENAME TOnew_name
ALTER FOREIGN DATA WRAPPER 更改外部数据包装器的定义。该命令的第一种形式更改外部数据包装器的支持函数或通用选项(至少需要一个子句)。第二种形式更改外部数据包装器的拥有者。
只有超级用户可以更改外部数据包装器。此外,只有超级用户才能成为外部数据包装器的拥有者。
name #一个现有外部数据包装器的名称。
HANDLER handler_function #为外部数据包装器指定一个新的处理器函数。
NO HANDLER #用于指定该外部数据包装器不再具有一个处理器函数。
注意,使用没有处理器函数的外部数据包装器的外部表将无法访问。
VALIDATOR validator_function #为外部数据包装器指定一个新的验证器函数。
注意,该外部数据包装器本身或者依赖它的服务器、用户映射或外部表中预先存在的选项,根据新的验证器可能是无效的。PostgreSQL 不会检查这一点。用户必须在使用修改后的外部数据包装器之前自行确保这些选项正确。不过,在此 ALTER FOREIGN DATA WRAPPER 命令中指定的任何选项,都会使用新的验证器进行检查。
NO VALIDATOR #用于指定该外部数据包装器不再具有验证器函数。
CONNECTION connection_function #指定外部数据包装器的新连接函数。
NO CONNECTION #用于指定该外部数据包装器不再具有连接函数。
OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) #更改外部数据包装器的选项。ADD、SET 和 DROP 指定要执行的动作。如果未显式指定操作,则假定为 ADD。选项名称必须唯一;如果存在验证器函数,选项名称和值也会使用该外部数据包装器的验证器函数进行验证。
new_owner #该外部数据包装器的新拥有者的用户名。
new_name #该外部数据包装器的新名称。
更改外部数据包装器 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;
ALTER FOREIGN DATA WRAPPER 符合 ISO/IEC 9075-9 (SQL/MED),但 HANDLER、VALIDATOR、OWNER TO 和 RENAME 子句属于扩展。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游会在正式发布前持续修订。