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