Mapping ノードで DB2® または Oracle データベース・ストアード・プロシージャーをソースとして使用します。
データベース・ストアード・プロシージャーからターゲット・エレメントをマップするには、
Mapping ノードを次のようにセットアップします。
- ストアード・プロシージャーを実行してデータベースから該当する行を取得する
- メッセージのターゲット・エレメントにデータベースからの値を取り込む
ストアード・プロシージャーからターゲット・エレメントをマップするには、以下のステップを実行します。
- ソースまたはターゲットとしてデータベースを追加するで説明されているとおり、ストアード・プロシージャーをマッピングのソースとして追加します。 ストアード・プロシージャーをマッピングに追加したら、「ソース」ペインおよび「スプレッドシート」ペインに $db:proc 項目が含まれます。 これらの $db:proc 項目には、ストアード・プロシージャーによって使用されるパラメーターの詳細が含まれています。 パラメーターごとに、その名前、モード (IN、INOUT、OUT のいずれか)、およびデータ・タイプが示されます。
「スプレッドシート」ペインの $db:proc 項目には 'for' 行も含まれます。 デフォルトでは、$db:proc 項目での 'for' 行の位置は、結果セットに複数のレコードがあるときに、出力メッセージ本体に反復エレメントが含まれることを示します。 結果セット内のレコードごとに別々のメッセージを出力する場合、「スプレッドシート」ペインの $target エレメントを 'for' 行の下に移動させます。
結果セットの最大数を指定する DB2 ストアード・プロシージャーを使用している場合、「ソース」ペインには結果セットのリストも含まれます。 モード INOUT または OUT の ref カーソル・パラメーターを指定する Oracle ストアード・プロシージャーを使用している場合、Mapping ノードはそのパラメーターをパラメーターとしてではなく指定された結果セットとして扱います。 Mapping ノードはモード IN の ref カーソル・パラメーターをサポートしません。
- ストアード・プロシージャーのパラメーターがモード IN または INOUT である場合、それぞれに値を指定します。
- 「スプレッドシート」ペインのパラメーターの隣の「値」フィールドに式を入力します。
- 「スプレッドシート」ペインでパラメーターを選択し、エレメントをソース・メッセージから「編集」ペインにドラッグして、Enter を押します。
- ストアード・プロシージャーが戻り値を設定する場合、「ソース」ペインで $db:proc 項目を右クリックし、「ストアード・プロシージャーの戻り値の追加または除去の切り替え」を選択します。 タイプ INTEGER の ReturnValue というエレメントが「ソース」ペインに追加されます。
ストアード・プロシージャーが戻り値を設定しない場合、分散システム上の DB2 は SQLCODE を戻します。
DB2 on z/OS® および Oracle ストアード・プロシージャーは戻り値を設定しません。
- ストアード・プロシージャーが戻す結果セットごとに、そこに含まれる列を定義します。
- 「ソース」ペインで結果セット項目を右クリックし、「結果セット列の追加または除去」を選択します。 「結果セット列の追加または除去」ウィンドウが開きます。
- (オプション) 「以前の設定値を次の場所から復元」リストから項目を選択します。 「結果セット列」リストが置き換えられます。
- (オプション) 「使用可能なデータベース表列」リストで列を選択し、それを「結果セット列」リストに追加します。
- (オプション) 「新しい列」フィールドに列名を入力し、それを「結果セット列」リストに追加します。 この方法を使用して、ストアード・プロシージャーで指定されている計算済みの列を追加します。
- (オプション) 「完了」をクリックしたときに「結果セット列」に表示される列を保存するために使用される名前を「現在の設定値を次の場所に保存」フィールドで変更します。 設定は ¥.metadata ディレクトリーに保存されます。
ステップ 4a で説明されているとおり、別のメッセージ・マップでこれらの設定を取り出すことができます。 デフォルトの名前を変更しない場合、ストアード・プロシージャーが別のメッセージ・マップで使用されるときに自動的に設定が取り出されます。