CREATE USER MAPPING ステートメント

CREATE USER MAPPING ステートメントは、フェデレーテッド・データベースを使用する許可 ID と、 指定したデータ・ソースで使用する許可 ID およびパスワードとの間のマッピングを定義します。

呼び出し

このステートメントは、アプリケーション・プログラムに組み込んだり、動的 SQL ステートメントを使用して発行したりすることができます。 これは、DYNAMICRULES の実行動作がパッケージに効力を持つ場合にのみ、動的に準備できる実行可能ステートメントです (SQLSTATE 42509)。

許可

ステートメントの許可 ID がデータ・ソースへマップされる許可名とは異なる場合、そのステートメントの許可 ID が持つ特権には DBADM 権限が含まれている必要があります。 許可 ID と許可名が一致する場合は、権限や特権は必要ありません。

パブリック・ユーザー・マッピングを作成する場合は、このステートメントの許可 ID が持つ特権には、DBADM 権限が含まれている必要があります。

構文

構文図を読む構文図をスキップするCREATE USER MAPPING FORauthorization-nameUSERPUBLICSERVERserver-name OPTIONS(,user-mapping-option-namestring-constant)

説明

authorization-name
ユーザーまたはアプリケーションがフェデレーテッド・データベースへ接続するときの、 許可名を指定します。 authorization_name は REMOTE_AUTHID ユーザー・マッピング・オプションにマップされます。
USER
USER 特殊レジスターの値。USER が指定されている場合、 CREATE USER MAPPING ステートメントを出す許可 ID は REMOTE_AUTHID ユーザー・マッピング・オプションにマップされます。
PUBLIC
ローカル・フェデレーテッド・データベース用の有効な許可 ID を、REMOTE_AUTHID ユーザー・オプションで指定したデータ・ソース用の許可 ID にマップすることを指定します。
SERVER server-name
authorization-name (許可名) がアクセスできる データ・ソースのサーバー・オブジェクトを指定します。 server-name はフェデレーテッド・データベースに登録されている リモート・サーバーのローカル名です。
OPTIONS
作成するユーザー・マッピングの構成オプションを指定します。 指定可能なオプションは、ユーザー・マッピングの作成対象オブジェクトのデータ・ソースによって異なります。データ・ソースとそれぞれに当てはまるユーザー・マッピング・オプションのリストについては、データ・ソース・オプションを参照してください。 各オプション値は文字ストリング定数で、単一引用符で囲む必要があります。

注

  • ユーザー・マッピングは、IBM® データベース製品、Documentum、Informix®、 Microsoft SQL Server、ODBC、 Oracle、Sybase、および Teradata のデータ・ソースにのみ必要です。
  • REMOTE_PASSWORD オプションはユーザー・マッピングには常に必要です。
  • パブリック・ユーザー・マッピングと非パブリック・ユーザー・マッピングが同一フェデレーテッド・サーバーに共存することはできません。 つまり、パブリック・ユーザー・マッピングを作成した場合は、その同じフェデレーテッド・サーバーに非パブリック・ユーザー・マッピングを作成できないことになります。 またその逆に、非パブリック・ユーザー・マッピングを作成した場合は、その同じフェデレーテッド・サーバーにパブリック・ユーザー・マッピングを作成できないことになります。

例

  1. Oracle データ・ソース・サーバー・オブジェクト ORACLE1 への ユーザー・マッピングを登録します。MARCR は、ローカルのフェデレーテッド・データベースの許可名で、ORACLE1 のユーザー ID です。 許可名とユーザー ID が同じなので、 ユーザー・マッピングに REMOTE_AUTHID オプションを指定する必要はありません。 ORACLE1 上の MARCR のパスワードは NZXCZY です。 
      CREATE USER MAPPING FOR MARCR
    SERVER ORACLE1
    OPTIONS
    (REMOTE_PASSWORD 'NZXCZY')