ALTER SERVER

Name

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

Synopsis

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