ALTER FOREIGN DATA WRAPPER — 外部データラッパの定義を変更する
ALTER FOREIGN DATA WRAPPERname
[ HANDLERhandler_function
| NO HANDLER ] [ VALIDATORvalidator_function
| NO VALIDATOR ] [ OPTIONS ( [ ADD | SET | DROP ]option
['value
'] [, ... ]) ] ALTER FOREIGN DATA WRAPPERname
OWNER TO {new_owner
| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER FOREIGN DATA WRAPPERname
RENAME TOnew_name
ALTER FOREIGN DATA WRAPPER
は外部データラッパの定義を変更します。
このコマンドの第1の構文はサポート関数または外部データラッパの一般的なオプションを変更します。
(少なくとも1つの句が必要です。)
第2の構文は外部データラッパの所有者を変更します。
スーパーユーザのみが外部データラッパを変更することができます。 さらにスーパーユーザのみが外部データラッパを所有することができます。
name
既存の外部データラッパの名前です。
HANDLER handler_function
外部データラッパ用の新しいハンドラ関数を指定します。
NO HANDLER
これを使用して外部データラッパがハンドラ関数を持たないことを指定します。
ハンドラを持たない外部データラッパを使用する外部テーブルにはアクセスできないことに注意してください。
VALIDATOR validator_function
外部データラッパ用の新しい検証関数を指定します。
外部データラッパや依存するサーバ、ユーザマップ、外部テーブルの既存のオプションが新しい検証関数に対して無効となる可能性があることに注意してください。
PostgreSQLはこの検査を行いません。
変更された外部データラッパを使用する前にこれらのオプションが正しいことを確実にすることはユーザの責任です。
しかしこのALTER FOREIGN DATA WRAPPER
コマンドで指定されたオプションはすべて新しい検証関数で検査されます。
NO VALIDATOR
これは、外部データラッパが検証関数を持たないことを指定するために使用されます。
OPTIONS ( [ ADD | SET | DROP ] option
['value
'] [, ... ] )
外部データラッパ用のオプションを変更します。
ADD
、SET
、DROP
は実行する動作を指定します。
明示的な動作の指定がなければADD
とみなされます。
オプション名は一意でなければなりません。
また名前と値は外部データラッパの検証関数を使用して検証されます。
new_owner
外部データラッパの新しい所有者のユーザ名です。
new_name
外部データラッパの新しい名前です。
外部データラッパdbi
を変更し、foo
オプションを追加し、bar
オプションを削除します。
ALTER FOREIGN DATA WRAPPER dbi OPTIONS (ADD foo '1', DROP 'bar');
外部データラッパdbi
の検証関数をbob.myvalidator
に変更します。
ALTER FOREIGN DATA WRAPPER dbi VALIDATOR bob.myvalidator;
ALTER FOREIGN DATA WRAPPER
はISO/IEC 9075-9 (SQL/MED)に従います。
ただし、 HANDLER
、VALIDATOR
、OWNER TO
、RENAME
句は拡張です。