バージョンごとのドキュメント一覧

ALTER SERVER

ALTER SERVER <refpurpose>change the definition of a foreign server</refpurpose> — 外部サーバの定義を変更する

概要

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

説明

<title>Description</title>

<command>ALTER SERVER</command> changes the definition of a foreign server. The first form changes the server version string or the generic options of the server (at least one clause is required). The second form changes the owner of the server. ALTER SERVERは外部サーバの定義を変更します。 第1の構文はサーバのバージョン文字列、またはサーバの一般的なオプションを変更します。 (少なくとも1つの句が必要です。) 第2の構文はサーバの所有者を変更します。

To alter the server you must be the owner of the server. Additionally to alter the owner, you must be able to <literal>SET ROLE</literal> to the new owning role, and you must have <literal>USAGE</literal> privilege on the server's foreign-data wrapper. (Note that superusers satisfy all these criteria automatically.) サーバを変更するためには、サーバの所有者でなければなりません。 さらに所有者を変更するためには、新しい所有者ロールに対してSET ROLEができなければなりません。また、サーバの外部データラッパーに対してUSAGE権限も必要です。 (スーパーユーザはこれらの判定基準すべてを自動的に満たしていることに注意してください。)

パラメータ

<title>Parameters</title>
name

The name of an existing server. 既存のサーバの名前です。

new_version

New server version. 新しいサーバのバージョンです。

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

Change options for the server. <literal>ADD</literal>, <literal>SET</literal>, and <literal>DROP</literal> specify the action to be performed. <literal>ADD</literal> is assumed if no operation is explicitly specified. Option names must be unique; names and values are also validated using the server's foreign-data wrapper library. サーバのオプションを変更します。 ADDSETDROPは行う動作を指定します。 明示的な動作の指定がない場合ADDとみなされます。 オプション名は一意でなければなりません。 また、名前と値はサーバの外部データラッパーのライブラリを使用して検証されます。

new_owner

The user name of the new owner of the foreign server. 外部サーバの新しい所有者のユーザ名です。

new_name

The new name for the foreign server. 外部サーバの新しい名前です。

<title>Examples</title>

Alter server <literal>foo</literal>, add connection options: サーバfooを変更し、接続オプションを追加します。

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

Alter server <literal>foo</literal>, change version, change <literal>host</literal> option: サーバfooを変更し、バージョンとhostオプションを変更します。

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

互換性

<title>Compatibility</title>

<command>ALTER SERVER</command> conforms to ISO/IEC 9075-9 (SQL/MED). The <literal>OWNER TO</literal> and <literal>RENAME</literal> forms are PostgreSQL extensions. ALTER SERVERはISO/IEC 9075-9 (SQL/MED)に従います。 OWNER TORENAME構文はPostgreSQLの拡張です。

関連項目

<title>See Also</title> CREATE SERVER, DROP SERVER