PostgreSQL 16 文档: ALTER SERVER

ALTER SERVER
上一个	向上	SQL 命令	主页	下一个

ALTER SERVER

ALTER SERVER — 更改外部服务器的定义

语法

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

描述

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

要更改服务器，您必须是该服务器的所有者。此外，要更改所有者，您必须能够将 SET ROLE 设置为新的所有者角色，并且您必须对服务器的外键数据包装器拥有 USAGE 权限。（请注意，超级用户自动满足所有这些条件。）

参数

name: 现有服务器的名称。
new_version: 新服务器版本。
OPTIONS ( [ ADD | SET | DROP ] 选项 ['值'] [, ... ] ): 更改服务器选项。 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