ALTER SERVER

修改一个外部服务器的定义。

概要

ALTER SERVER server_name [ VERSION 'new_version' ]
    [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) ]

ALTER SERVER server_name OWNER TO new_owner

ALTER SERVER server_name RENAME TO new_name

描述

ALTER SERVER 更改外部服务器的定义。 命令的第一种形式更改服务器的版本字符串或通用选项。 YMatrix 数据库需要至少一个子句。 该命令的第二和第三种形式更改服务器的所有者或名称。

要更改服务器,您必须是服务器的所有者。 要更改所有者,用户必须:

  • 拥有服务器。
  • 成为新拥有角色的直接或间接成员。
  • 在服务器的外部数据包装程序上具有USAGE特权。

超级用户自动满足所有这些条件。

参数

server_name

  • 现有服务器的名称。

new_version

  • 新的服务器版本。

OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] )

  • 更改服务器的选项。 ADD, SET 和 DROP 指定要执行的操作。 如果未明确指定任何操作,则默认操作为ADD。 选项名称必须唯一。 YMatrix 数据库使用服务器的外部数据包装器库来验证名称和值。

OWNER TO new_owner

  • 指定外部服务器的新所有者。

RENAME TO new_name

  • 指定外部服务器的新名称。

示例

通过添加连接选项来更改名为 foo 的服务器的定义:

ALTER SERVER foo OPTIONS (host 'foo', dbname 'foodb');

为名为 foo 的服务器更改名为 host 的选项,并设置服务器版本:

ALTER SERVER foo VERSION '9.1' OPTIONS (SET host 'baz');

兼容性

ALTER SERVER 符合 ISO/IEC 9075-9 (SQL/MED)。 OWNER TO 和 RENAME 选项是 YMatrix 数据库的扩展。

另见

CREATE SERVERDROP SERVER