ALTER SERVER

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

g概要

  1. ALTER SERVER server_name [ VERSION 'new_version' ]
  2. [ OPTIONS ( [ ADD | SET | DROP ] option ['value'] [, ... ] ) ]
  3. ALTER SERVER server_name OWNER TO new_owner
  4. ALTER SERVER server_name RENAME TO new_name

Description

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

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

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

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

参数

server_name

现有服务器的名称。

new_version

新的服务器版本。

OPTIONS ( [ ADD | SET | DROP ] option [‘value’] [, … ] )

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

OWNER TO new_owner

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

RENAME TO new_name

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

Examples

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

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

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

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

兼容性

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

另见

CREATE SERVER, DROP SERVER

Parent topic: SQL Command Reference