SQL COMMAND · 外部数据

ALTER FOREIGN DATA WRAPPER

更改外部数据包装器的定义

change the definition of a foreign-data wrapper

ALTER外部数据引入 8.4现存至 20 devel5 次语法变更

动词: ALTER
对象: FOREIGN DATA WRAPPER
分组: 外部数据
引入版本: 8.4
状态: 现存
语法变更次数: 5
手册小节数: 5

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

ALTER FOREIGN DATA WRAPPER · 语法 2

ALTER FOREIGN DATA WRAPPER · 语法 3

语法概要

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

PostgreSQL 18 手册 · 查看完整参考页

描述

ALTER FOREIGN DATA WRAPPER 更改外部数据包装器的定义。该命令的第一种形式更改外部数据包装器的支持函数或通用选项（至少需要一个子句）。第二种形式更改外部数据包装器的拥有者。

只有超级用户可以更改外部数据包装器。此外，只有超级用户才能成为外部数据包装器的拥有者。

参数

name

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

HANDLER handler_function

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

NO HANDLER

用于指定该外部数据包装器不再具有一个处理器函数。

注意，使用没有处理器函数的外部数据包装器的外部表将无法访问。

VALIDATOR validator_function

为外部数据包装器指定一个新的验证器函数。

注意，该外部数据包装器本身或者依赖它的服务器、用户映射或外部表中预先存在的选项，根据新的验证器可能是无效的。PostgreSQL 不会检查这一点。用户必须在使用修改后的外部数据包装器之前自行确保这些选项正确。不过，在此 ALTER FOREIGN DATA WRAPPER 命令中指定的任何选项，都会使用新的验证器进行检查。

NO VALIDATOR

用于指定该外部数据包装器不再具有验证器函数。

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 子句属于扩展。

另见

CREATE FOREIGN DATA WRAPPER, DROP FOREIGN DATA WRAPPER

语法演化

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

PostgreSQL 19← 18语法变化

+ [ VALIDATOR validator_function | NO VALIDATOR ]+ [ CONNECTION connection_function | NO CONNECTION ]正文更新
PostgreSQL 14← 13语法变化

+ ALTER FOREIGN DATA WRAPPER name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
PostgreSQL 12← 11正文更新

正文更新
PostgreSQL 9.5← 9.4语法变化

+ ALTER FOREIGN DATA WRAPPER name OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
PostgreSQL 9.3← 9.2正文更新

正文更新
PostgreSQL 9.2← 9.1语法变化

+ ALTER FOREIGN DATA WRAPPER name RENAME TO new_name正文更新
PostgreSQL 9.1← 9.0语法变化

+ [ HANDLER handler_function | NO HANDLER ]+ [ VALIDATOR validator_function | NO VALIDATOR ]− [ VALIDATOR valfunction | NO VALIDATOR ]正文更新
PostgreSQL 8.4← 8.3新增此命令

同组命令

命令	动词	对象	最近变更
FOREIGN DATA外部数据13 条↑
`CREATE FOREIGN DATA WRAPPER`	CREATE	FOREIGN DATA WRAPPER	192 次
定义一个新的外部数据包装器			现存
`ALTER FOREIGN DATA WRAPPER`	ALTER	FOREIGN DATA WRAPPER	195 次
更改外部数据包装器的定义			现存
`DROP FOREIGN DATA WRAPPER`	DROP	FOREIGN DATA WRAPPER	101 次
移除一个外部数据包装器			现存
`IMPORT FOREIGN SCHEMA`	IMPORT	FOREIGN SCHEMA	—
从一个外部服务器导入表定义			现存
`CREATE FOREIGN TABLE`	CREATE	FOREIGN TABLE	187 次
定义一个新外部表			现存
`ALTER FOREIGN TABLE`	ALTER	FOREIGN TABLE	167 次
更改外部表的定义			现存
`DROP FOREIGN TABLE`	DROP	FOREIGN TABLE	—
移除一个外部表			现存
`CREATE SERVER`	CREATE	SERVER	102 次
定义一个新的外部服务器			现存
`ALTER SERVER`	ALTER	SERVER	144 次
更改外部服务器的定义			现存
`DROP SERVER`	DROP	SERVER	103 次
移除一个外部服务器描述符			现存
`CREATE USER MAPPING`	CREATE	USER MAPPING	143 次
定义用户到外部服务器的新映射			现存
`ALTER USER MAPPING`	ALTER	USER MAPPING	143 次
更改用户映射的定义			现存
`DROP USER MAPPING`	DROP	USER MAPPING	142 次
删除外部服务器的用户映射			现存

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

参数

示例

兼容性

另见

语法演化

相关命令

同组命令