Postgresql 中文操作指南

ALTER FOREIGN DATA WRAPPER

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_ROLE | 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_

    • 为外键数据包装器指定一个新的验证程序函数。

    • 请注意,外键数据包装器或依赖服务器、用户映射或外来表的现有选项可能根据新的验证程序无效。PostgreSQL 不会检查这一点。用户负责确保在使用修改后的外键数据包装器之前,这些选项是正确的。但是,在此 ALTER FOREIGN DATA WRAPPER 命令中指定的任何选项都将使用新验证程序进行检查。

  • NO VALIDATOR

    • 这用于指定外键数据包装器不再具有验证程序函数。

  • OPTIONS ( [ ADD | SET | DROP ] _option [' value '] [, …​ ] )_

    • 更改外键数据包装器的选项。 ADDSETDROP 指定要执行的操作。如果未明确指定操作,则假定为 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),但 HANDLERVALIDATOROWNER TORENAME 条款除外。