↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4
历史版本。 PostgreSQL 13 已结束支持。 2025-11-13. 请参阅 当前版本手册.

ALTER SERVER

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

大纲

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

描述

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

要更改服务器,必须是服务器的所有者。此外,要更改所有者,还必须拥有该服务器,是新所有者角色的直接或间接成员,并且必须在服务器的外部数据包装器上拥有 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 扩展。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.