このトピックでは、CREATE user mappingを使用して、ユーザーから外部サーバーへの新しいマッピングを定義する方法について説明します。
構文
CREATE USER MAPPING [IF NOT EXISTS] FOR { user_name | USER | CURRENT_USER | PUBLIC } SERVER server_name [ OPTIONS ( option 'value' [ , ... ] ) ]使用上の注意
CREATE USER MAPPINGは、ユーザーから外部サーバーへの新しいマッピングを定義するために使用されます。 ほとんどの場合、ユーザマッピングは接続情報を含む。 外部データラッパは、外部データソースにアクセスするために、外部サーバに含まれる情報と共にその接続情報を使用する。
外部サーバの所有者は、すべてのタイプのユーザに対してサーバへのユーザマッピングを作成することができる。 サーバーでUSAGE権限が付与されている場合は、ユーザー名をサーバーにマップできます。
コンポーネント
コンポーネント | 説明 |
IF NOT EXISTS | 特定のユーザーから特定の外部サーバーへのユーザーマッピングが既に存在する場合は、エラーをスローしないでください。 代わりに通知を発行します。 説明 既存のユーザーマッピングは、作成するユーザーマッピングとまったく同じではない場合があります。 |
user_name | 外部サーバーにマップされる既存のユーザーの名前。 CURRENT_USERとUSERは、現在のユーザーの名前と一致します。 PUBLICを指定すると、パブリックマッピングが作成されます。 パブリックマッピングは、特定のユーザーが利用できるマッピングがない場合に使用されます。 |
server_name | ユーザーがマップされている既存のサーバーの名前。 |
OPTIONS (option'value' [, ... ] ) | この句は、ユーザーマッピングのオプションを指定します。 ほとんどの場合、これらのオプションはマッピングの実際のユーザー名とパスワードを定義します。 オプション名は一意である必要があります。 許可されるオプションの名前と値は、このサーバーの外部データラッパーによって異なります。 |
例
次のサンプルコードは、bobという名前のユーザーとfooという名前のサーバーのユーザーマッピングを作成する方法を示しています。
CREATE USER MAPPING FOR bob SERVER foo OPTIONS (user 'bob', password 'secret');