ターゲット・エレメントのデータベース・ストアード・プロシージャーからのマッピング

Mapping ノードで DB2® または Oracle データベース・ストアード・プロシージャーをソースとして使用します。

始める前に:

データベース・ストアード・プロシージャーをデータベース定義に含める必要があります。 WebSphere Message Broker Toolkit へのデータベース定義の追加を参照してください。 このタスクでは、DB2 および Oracle データベースのみがサポートされます。

データベース・ストアード・プロシージャーからターゲット・エレメントをマップするには、Mapping ノードを次のようにセットアップします。
  • ストアード・プロシージャーを実行してデータベースから該当する行を取得する
  • メッセージのターゲット・エレメントにデータベースからの値を取り込む

ストアード・プロシージャーからターゲット・エレメントをマップするには、以下のステップを実行します。

  1. ソースまたはターゲットとしてデータベースを追加するで説明されているとおり、ストアード・プロシージャーをマッピングのソースとして追加します。 ストアード・プロシージャーをマッピングに追加したら、「ソース」ペインおよび「スプレッドシート」ペインに $db:proc 項目が含まれます。 これらの $db:proc 項目には、ストアード・プロシージャーによって使用されるパラメーターの詳細が含まれています。 パラメーターごとに、その名前、モード (IN、INOUT、OUT のいずれか)、およびデータ・タイプが示されます。

    「スプレッドシート」ペインの $db:proc 項目には 'for' 行も含まれます。 デフォルトでは、$db:proc 項目での 'for' 行の位置は、結果セットに複数のレコードがあるときに、出力メッセージ本体に反復エレメントが含まれることを示します。 結果セット内のレコードごとに別々のメッセージを出力する場合、「スプレッドシート」ペインの $target エレメントを 'for' 行の下に移動させます。

    結果セットの最大数を指定する DB2 ストアード・プロシージャーを使用している場合、「ソース」ペインには結果セットのリストも含まれます。 モード INOUT または OUT の ref カーソル・パラメーターを指定する Oracle ストアード・プロシージャーを使用している場合、Mapping ノードはそのパラメーターをパラメーターとしてではなく指定された結果セットとして扱います。 Mapping ノードはモード IN の ref カーソル・パラメーターをサポートしません。

  2. ストアード・プロシージャーのパラメーターがモード IN または INOUT である場合、それぞれに値を指定します。
    1. 「スプレッドシート」ペインのパラメーターの隣の「値」フィールドに式を入力します。
    2. 「スプレッドシート」ペインでパラメーターを選択し、エレメントをソース・メッセージから「編集」ペインにドラッグして、Enter を押します。
  3. ストアード・プロシージャーが戻り値を設定する場合、「ソース」ペインで $db:proc 項目を右クリックし、「ストアード・プロシージャーの戻り値の追加または除去の切り替え」を選択します。 タイプ INTEGER の ReturnValue というエレメントが「ソース」ペインに追加されます。

    ストアード・プロシージャーが戻り値を設定しない場合、分散システム上の DB2 は SQLCODE を戻します。

    DB2 on z/OS® および Oracle ストアード・プロシージャーは戻り値を設定しません。

  4. ストアード・プロシージャーが戻す結果セットごとに、そこに含まれる列を定義します。
    1. 「ソース」ペインで結果セット項目を右クリックし、「結果セット列の追加または除去」を選択します。 「結果セット列の追加または除去」ウィンドウが開きます。
    2. (オプション) 「以前の設定値を次の場所から復元」リストから項目を選択します。 「結果セット列」リストが置き換えられます。
    3. (オプション) 「使用可能なデータベース表列」リストで列を選択し、それを「結果セット列」リストに追加します。
    4. (オプション) 「新しい列」フィールドに列名を入力し、それを「結果セット列」リストに追加します。 この方法を使用して、ストアード・プロシージャーで指定されている計算済みの列を追加します。
    5. (オプション) 「完了」をクリックしたときに「結果セット列」に表示される列を保存するために使用される名前を「現在の設定値を次の場所に保存」フィールドで変更します。 設定は ¥.metadata ディレクトリーに保存されます。 ステップ 4a で説明されているとおり、別のメッセージ・マップでこれらの設定を取り出すことができます。 デフォルトの名前を変更しない場合、ストアード・プロシージャーが別のメッセージ・マップで使用されるときに自動的に設定が取り出されます。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        最終更新
        
        最終更新 : 2012-08-03 11:56:11


タスク・トピックタスク・トピック | バージョン 7.0.0.5 | ar25284_