Redrock Postgres 搜索 英文
版本: 9.3 / 9.4 / 9.5 / 9.6 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17

ALTER FOREIGN DATA WRAPPER

ALTER FOREIGN DATA WRAPPER — 更改外部数据包装器的定义

语法

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

描述

ALTER FOREIGN DATA WRAPPER 更改外部数据包装器的定义。这一命令的第一种形式更改外部数据包装器的支持函数或常规选项(至少需要一个子句)。第二种形式更改外部数据包装器所有者的所有者。

只有超级用户才能更改外部数据包装器。此外,只有超级用户才能拥有外部数据包装器。

参数

名称

一个现有的外部数据包装器的名称。

HANDLER 处理程序函数

为外部数据包装器指定一个新的处理程序函数。

NO HANDLER

用于指定外部数据包装器不再应具有处理程序函数。

请注意,由于没有处理程序,因此外部表无法使用外部数据包装器。

VALIDATOR validator_function

为外部数据包装器指定新的验证器功能。

请注意,根据新验证器,当前外部数据包装器的选项或依赖服务器、用户映射或外表的选项可能无效。PostgreSQL 并不对此进行检查。在使用修改后的外部数据包装器之前,应由用户确保这些选项正确。但是,此 ALTER FOREIGN DATA WRAPPER 命令中指定的任何选项都将使用新验证器进行检查。

NO VALIDATOR

用于指定外部数据包装器不再应具有验证器功能。

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

更改外部数据包装器的选项。ADDSETDROP 指定要执行的操作。如果未明确指定操作,则假定为 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),但 HANDLERVALIDATOROWNER TORENAME 子句除外,它们是扩展。

另请参阅

创建外部数据包装器删除外部数据包装器