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

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

Wiki / SQL 命令

ALTER SERVER

更改外部服务器的定义

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

8.49.09.19.29.39.49.59.61011121314151617181920
anchor
SQL-ALTERSERVER
file
sql-alterserver.html
lang
en
name
ALTER SERVER
purpose
change the definition of a foreign server
purpose zh
未知
sections same as
未知
slug
18
synopsis text
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 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 name VERSION ' new_version ' OPTIONS ( ADD SET DROP option ' value ' , )
ALTER SERVER · 语法 2
ALTER SERVER name OWNER TO new_owner CURRENT_ROLE CURRENT_USER SESSION_USER
ALTER SERVER · 语法 3
ALTER SERVER name RENAME TO new_name

版本定义 PG 18

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

比较版本

完整来源事实

synopsis html

ALTER SERVER <em class="replaceable"><code>name</code></em> [ VERSION '<em class="replaceable"><code>new_version</code></em>' ]
    [ OPTIONS ( [ ADD | SET | DROP ] <em class="replaceable"><code>option</code></em> ['<em class="replaceable"><code>value</code></em>'] [, ... ] ) ]
ALTER SERVER <em class="replaceable"><code>name</code></em> OWNER TO { <em class="replaceable"><code>new_owner</code></em> | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER SERVER <em class="replaceable"><code>name</code></em> RENAME TO <em class="replaceable"><code>new_name</code></em>

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c