CREATE SERVER — 新しい外部サーバを定義する
CREATE SERVER [ IF NOT EXISTS ]server_name
[ TYPE 'server_type
' ] [ VERSION 'server_version
' ] FOREIGN DATA WRAPPERfdw_name
[ OPTIONS (option
'value
' [, ... ] ) ]
CREATE SERVER
は新しい外部サーバを定義します。
サーバを定義したユーザがその所有者となります。
外部サーバは通常、外部データラッパが外部データリソースにアクセスするために使用する接続情報をカプセル化します。 さらに、ユーザマップによりユーザ指定の接続情報が指定される可能性があります。
サーバ名はデータベース内で一意でなければなりません。
サーバを作成するには、使用する外部データラッパ上にUSAGE
権限が必要です。
IF NOT EXISTS
同じ名前のサーバが既に存在する時にエラーを発生させません。 この場合、注意メッセージが発行されます。 既存のサーバが、作成されようとしていたものと類似したものであるかどうか、全く保証されないことに注意してください。
server_name
作成する外部サーバの名前です。
server_type
サーバの種類(省略可能)です。 外部データラッパで有用かもしれません。
server_version
サーババージョン(省略可能)です。 外部データラッパで有用かもしれません。
fdw_name
このサーバを管理する外部データラッパの名前です。
OPTIONS ( option
'value
' [, ... ] )
この句はサーバのオプションを指定します。 オプションは通常、サーバの接続の詳細を定義しますが、実際の名前とその値はサーバの外部データラッパに依存します。
dblinkモジュールを使用している場合、接続パラメータを表すために、外部サーバ名をdblink_connect関数の引数として使用することができます。
この方法で利用できるようにするためには外部サーバ上にUSAGE
権限が必要です。
外部データラッパpostgres_fdw
を使用するmyserver
サーバを作成します。
CREATE SERVER myserver FOREIGN DATA WRAPPER postgres_fdw OPTIONS (host 'foo', dbname 'foodb', port '5432');
詳細についてはpostgres_fdwを参照してください。
CREATE SERVER
はISO/IEC 9075-9 (SQL/MED)に従います。