データベース・マッピングをサポートしているメッセージ・マップに、ソースとしてデータベースを、またターゲットとしてデータベース表を追加します。
データベースまたはそれに関連する表をメッセージ・マップに追加する前に、データベースのデータベース定義を作成する必要があります。
データベースのソースおよびターゲットは、以下のさまざまな方法で追加できます。
- 既存のメッセージ・マップでは、「データ・ソースの選択」をクリックして、データベースをソースとして追加します。
- 「スプレッドシート」ペインで、データベース表ソースをマッピングに追加するロケーションを選択します。 例えば、$target を選択します。
- をクリックします。 あるいは、「スプレッドシート」ペインで右クリックして「データ・ソースの選択」をクリックします。 「マッピング・ソースとしてのデータベースの選択」ウィザードが開きます。
- リストからデータベースを選択します。 使用するデータ・ソースまたはデータ・ターゲットが見つからない場合は、「このページの成果物選択に作業セット・フィルターを適用」のチェックを外して追加のオプションを表示させます。
- マップ・ファイルの作成時にデータベース・ソースを選択する際に、データベース・ソースは、マップ内の 1 つ以上のメッセージ・ターゲットの兄弟として (コンテナーとは対照的に) マップ・スクリプトに配置されます。 データベース・ソースの項目からマッピングを作成する際に、マッパーは、マップ・スクリプト構造のデータベース・ソースを、データベース・ソースを使用するすべてのマッピングの最も下位のコンテナーに移動します。
ドラッグ・アンド・ドロップまたはコピー・アンド・ペーストを使用することによって、マップ・スクリプト内のデータベース・ソースを移動できます。
- メッセージ・マップを作成するときに、使用するデータベースおよびデータベース表を「新規メッセージ・マップ」ウィザードで指定できます。
- メッセージ・マップ・ファイルを作成するには、を使用するか、またはマッピング・ノードを右クリックして、「マップをオープン」を選択します。
- 「マップ・ソースの選択」で、メッセージ・マップのデータベース・ソースを選択します。
- 「マップ・ターゲットの選択」で、メッセージ・マップでターゲットとして使用するデータベース表を選択します。 メッセージ・マップを DataDelete、DataInsert、または DataUpdate ノードから作成しない場合は、関連するデータベース操作を拡張して、表のリストから選択します。 次のデータベース操作を選択できます。
使用するデータ・ソースまたはデータ・ターゲットが見つからない場合は、「このページの成果物選択に作業セット・フィルターを適用」のチェックを外して追加のオプションを表示させます。
- マップ・ファイルの作成時にデータベース・ソースを選択する際に、データベース・ソースは、マップ内の 1 つ以上のメッセージ・ターゲットの兄弟として (コンテナーとは対照的に) マップ・スクリプトに配置されます。 データベース・ソースの項目からマッピングを作成する際に、マッパーは、マップ・スクリプト構造のデータベース・ソースを、データベース・ソースを使用するすべてのマッピングの最も下位のコンテナーに移動します。
ドラッグ・アンド・ドロップまたはコピー・アンド・ペーストを使用することによって、マップ・スクリプト内のデータベース・ソースを移動できます。
- 既存のメッセージ・マップでは、「ソースとターゲットを追加」をクリックして、データベースをソースとして、データベース表をターゲットとして追加します。
- メッセージ・マッピング・エディターで、
をクリックします。 あるいは、「ソース」ペインで右クリックし、「ソースの追加」をクリックするか、または「ターゲット」ペインで右クリックし、「ターゲットの追加」をクリックします。
- 「マップ・ソースの選択」で、メッセージ・マップのデータベース・ソースを選択します。
- データ・ターゲットからは、「マップ・ターゲットの選択」で、メッセージ・マップでターゲットとして使用するデータベース表を選択します。 メッセージ・マップを DataDelete、DataInsert、または DataUpdate ノードから作成しない場合は、関連するデータベース操作を拡張して、表のリストから選択します。 次のデータベース操作を選択できます。
使用するデータ・ソースまたはデータ・ターゲットが見つからない場合は、「このページの成果物選択に作業セット・フィルターを適用」のチェックを外して追加のオプションを表示させます。
ビュー内のエレメントのうち、名前が (read-only view) というアノテーション付きであるものにマップできます。
ビューは読み取り専用のため、「マップの追加」ダイアログでは「挿入」、「更新」、または「削除」のビューを選択できません。
- 「ソースの追加」アクションを使用してデータベース・ソースを追加する際に、データベース・ソースは、マップ内の 1 つ以上のメッセージ・ターゲットの兄弟として (コンテナーとは対照的に) マップ・スクリプトに配置されます。 データベース・ソースの項目からマッピングを作成する際に、マッパーは、マップ・スクリプト構造のデータベース・ソースを、データベース・ソースを使用するすべてのマッピングの最も下位のコンテナーに移動します。 ドラッグ・アンド・ドロップまたはコピー・アンド・ペーストを使用することによって、マップ・スクリプト内のデータベース・ソースを移動できます。
データベースがソースとして追加されると、次のようになります。
- 「ソース」ペインに $db:select 項目が含まれています。
- 「スプレッドシート」ペインに $db:select 項目が含まれています。
データベース表がターゲットとして追加されると、次のようになります。
Extract ノードにデータベースをソースまたはターゲットとして追加することはできません。