PostgreSQL 18 文档: 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 ] 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