2024年9月26日: PostgreSQL 17 发布!
支持的版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不受支持的版本:11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4

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'] [, ... ] )

更改服务器的选项。ADDSETDROP 指定要执行的操作。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 TORENAME 形式是 PostgreSQL 扩展。

另请参阅

CREATE SERVERDROP SERVER

提交更正

如果您在文档中发现任何不正确的内容、与您对特定功能的体验不符的内容或需要进一步澄清的内容,请使用 此表单 报告文档问题。