SQL COMMAND · 外部数据

ALTER SERVER

更改外部服务器的定义

ALTER外部数据引入 10（基线）现存至 20 devel1 次语法变更

动词: ALTER
对象: SERVER
分组: 外部数据
引入版本: 10（基线）
状态: 现存
语法变更次数: 1
手册小节数: 5

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

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

ALTER SERVER · 语法 2

ALTER SERVER · 语法 3

语法概要

ALTER SERVER name [ VERSION 'new_version' ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) ]
ALTER SERVER name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER SERVER name RENAME TO new_name

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

描述

ALTER SERVER更改外部服务器的定义。第一种形式更改服务器的版本字符串或其通用选项（至少需要一个子句）。第二种形式更改服务器的拥有者。

要更改服务器，你必须是该服务器的拥有者。此外，要更改拥有者，你必须能够对新的拥有角色执行SET ROLE，并且必须在该服务器的外部数据包装器上具有USAGE权限。（注意，超级用户会自动满足所有这些条件。）

参数

name: 一个现有服务器的名称。
new_version: 新服务器版本。
OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ): 更改服务器的选项。ADD、SET和 DROP指定要执行的动作。如果未显式指定操作，则假定为ADD。选项名称必须唯一；名称和值也会使用该服务器的外部数据包装器库进行验证。
new_owner: 该外部服务器的新拥有者的用户名。
new_name: 该外部服务器的新名称。

示例

更改服务器foo，添加连接选项：

ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');

更改服务器foo，更改版本并修改 host选项：

ALTER SERVER foo VERSION '8.4' OPTIONS (SET host 'baz');

兼容性

ALTER SERVER符合 ISO/IEC 9075-9 (SQL/MED)。 OWNER TO和RENAME形式是 PostgreSQL 扩展。

另见

CREATE SERVER, DROP SERVER

语法演化

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

PostgreSQL 14← 13语法变化

+ ALTER SERVER name OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }− ALTER SERVER name OWNER TO { new_owner | CURRENT_USER | SESSION_USER }正文更新

同组命令

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

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

参数

示例

兼容性

另见

语法演化

相关命令

同组命令