ALTER SERVER

名称

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

大纲

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

描述

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

要更改外部服务器,你必须是外部服务器的所有者。 此外要更改所有者,你必须是外部服务器的所有者并且也是新的所有者角色的直接或者间接成员,并且你必须对外部服务器的外部数据封装器有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 SERVER, DROP SERVER