★PostgreSQLカンファレンス2024 12月6日開催/チケット販売中★
他のバージョンの文書 16 | 15 | 14 | 13 | 12 | 11 | 10 | 9.6 | 9.5 | 9.4 | 9.3 | 9.2 | 9.1 | 9.0 | 8.4 | 8.3 | 8.2 | 8.1 | 8.0 | 7.4 | 7.3 | 7.2

CREATE SERVER

CREATE SERVER — 新しい外部サーバを定義する

概要

CREATE SERVER [ IF NOT EXISTS ] server_name [ TYPE 'server_type' ] [ VERSION 'server_version' ]
    FOREIGN DATA WRAPPER fdw_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)に従います。

関連項目

ALTER SERVER, DROP SERVER, CREATE FOREIGN DATA WRAPPER, CREATE FOREIGN TABLE, CREATE USER MAPPING