マップからのストアード・プロシージャーの呼び出し

グラフィカル・データ・マッピング・エディターを使用してデータベース・ルーチン変換を使用することにより、ストアード・プロシージャーを呼び出します。

始める前に:
以下のタスクを完了している必要があります。

データベース・ルーチン変換を使用して、データベースのストアード・プロシージャーを呼び出すことができます。

注: IBM® Integration Bus v9.0 でサポートされているのは IBM DB2® ストアード・プロシージャーのみです。

データベース・ルーチン変換はネストされたマッピングとして動作します。ストアード・プロシージャー呼び出しの入力パラメーター値を設定するため、マッピングを構成するための入力をこの変換にワイヤリングできます。 ルーチンの入力パラメーターは、データベース・ルーチンのネストされたマッピングの出力として表示されます。 データベース・ルーチン変換のどの出力もワイヤリングすることはできません。

データベース・ルーチンの変換グループ内の Return 変換を使用して、データベース・ルーチン呼び出しで生成された出力パラメーター、戻り値、または ResultSet をマップします。 データベース・ルーチン呼び出しが正常に完了したとき、追加でマップする入力をワイヤリングできます。 データベース・ルーチンに定義された出力パラメーター、戻り値、および戻り結果セットが、ネストされた Return マッピングで入力として提供されます。 Return を単一または複数の兄弟出力エレメントへワイヤリングして、返されたデータをマップ出力にマップできるようにすることができます。

グラフィカル・データ・マッピング・エディターを使用して、以下のステップを実行します。

  1. グラフィカル・データ・マッピング・エディターでグラフィカル・データ・マップ (.map) ファイルを開き、キャンバスを右クリックして、「データベース」 > 「データベース・ルーチンの呼び出し」を選択します。
    • あるいは、スキーマ・エレメント (複数も可) を入力パラメーター値として選択します。 オプションで、スキーマ・エレメント (複数も可) を出力値として選択します。
    • ドラッグ・アンド・ドロップを使用してデータベース・ルーチン変換を作成することもできます。 入力オブジェクトを出力オブジェクトに接続すると、変換が自動的に作成されます。 変換を選択し、「変換」リストから「データベース・ルーチン」を選択します。
    • 「データベースでストアード・プロシージャーを呼び出します」アイコン「データベースでストアード・プロシージャーを呼び出します」アイコン をクリックすることもできます。
    データベース・ルーチン・ウィザードが表示されます。
  2. 「データベース」フィールドで、ルーチンの呼び出し先データベースを選択します。 データベース定義ファイルを追加するか、JDBC を使用して IBM Integration Toolkit をデータベース・サーバーに接続することにより新しいデータベースを検出するには、「データベースの追加...」をクリックします。 詳しくは、「新規データベース定義ファイル」ウィザードを使用したデータベース定義の作成を参照してください。ディスカバリー・プロセス中に「ルーチン」オプションを選択する必要があります。 実行時に、Toolkit で使用したデータベース名とは異なる名前を使用する場合、データベースへの接続方法を定義する JDBCProvider 構成可能サービスの databaseName プロパティーを設定することにより、この値をオーバーライドできます。Type 4 接続用の JDBC プロバイダーのセットアップを参照してください。
  3. 「スキーマ」フィールドで、マップから呼び出すストアード・プロシージャーを定義するデータベース・スキーマを選択します。 実行時に別のデータベース・スキーマのストアード・プロシージャーを呼び出す場合、データベースへの接続方法を定義する JDBCProvider 構成可能サービスの databaseSchemaNames プロパティーを設定することにより、この値をオーバーライドできます。Type 4 接続用の JDBC プロバイダーのセットアップを参照してください。
  4. 「ルーチン」フィールドで、マップ内のデータベース・ルーチン変換を呼び出すストアード・プロシージャーを選択します。
    1. オプション: 選択したルーチンが値を返す場合があるときは、「戻り値」チェック・ボックスが表示されます。 Return 変換のマッピングで戻り値を使用できるようにする場合、このボックスにチェック・マークを付けます。
    注: このようにすると、選択された「ルーチン」によって、以下のロックされたフィールドにデータが設定されます。
    • タイプ: 選択された「ルーチン」のタイプがストアード・プロシージャーであるかどうかを示します。
    • パラメーター: 選択された「ルーチン」のパラメーターの名前、モード、およびタイプの詳細を示します。
    • 最大結果セット数: 「ルーチン」のデータベース定義ファイルがこの情報を提供している場合、結果セットの最大数を示します。 それ以外の場合、ブランクです。

    これらのフィールドは、「ルーチン・パラメーターの詳細表示...」をクリックすることにより表示できます。

  5. オプション: 「警告をエラーとして扱う」を選択します。 このオプションを選択すると、構成されたランタイム・データベースのデータベース・ルーチンを呼び出すと SQL 警告が返されます。これは、データベースが例外を出した場合と同様に処理されます。 Failure 変換がある場合、ネストされたマッピングに入ります。 それ以外の場合、マップは実行を停止し、マップを実行している Mapping ノードから例外が出されます。
    重要: データベース警告はベンダーによって異なります。 データベース警告の詳細については、データベース製品の資料を参照してください。
  6. オプション: 選択された「ルーチン」が結果セットを返す場合があり、その値をマップする場合は、その順序と列の内容を定義する必要があります。
    1. データベース定義ファイルによって結果セットの数が定義されている場合、「結果セット・リスト」に 1 つの ResultSet が事前データ設定され、返すことができる最大数が表示されます。 「追加」ボタンと「削除」ボタンを使用して、「結果セット・リスト」に、データベース定義ファイルで定義された最大数まで、データを設定します。 データベース・ルーチン・コードの定義に従って、結果セットを配列する必要があります。 データを、例えば 2 番目の結果セットのみからマップする場合であっても、表内の最初の結果セットを含める必要があります。これは、その位置順序に従ってアクセスされるからです。
    2. 各結果セットを選択し、「使用可能な表列」のチェック・ボックスを使用して、データベース・ルーチンが返す結果セットに一致する結果セットに列定義を追加します。 定義する必要があるのは、マッピングで使用可能にする結果セット列のみです。
  7. 「OK」をクリックします。 データベース・ルーチンと、そのグループ化された Return 変換はグラフィカル・データ・マップに表示されます。 マッピング入出力で何らかの選択をした場合、選択した入力はすべてデータベース・ルーチンにワイヤリングされ、出力は Return 変換にワイヤリングされます。 何も選択しなかった場合、マップに、未接続の新しい変換が表示されます。
  8. データベース・ルーチンの IN モードと INOUT モードのパラメーターに必要な値を指定します。 選択されたストアード・プロシージャーの入力パラメーターが、ネストされたデータベース・ルーチン変換の出力として表示されます。
    1. 必須入力エレメントをデータベース・ルーチンに接続し、ネストされたマップ内で各パラメーターに値を設定するための変換を指定します。 データベース・ルーチンに入るのは 1 回のみであり、データベース・システムへの呼び出しが 1 回行われます。 データベース・ルーチン変換に接続された繰り返しエレメントに対してカーディナリティーを設定するか、または関数変換を使用してパラメーターに単一の値を指定する必要があります。
      注: 値が指定されていないパラメーターがあり、データベース・サーバーで設定できるデフォルト値がない場合、データベース・サーバーから例外が返される可能性があります。 パラメーターを設定する変換の結果として得られる出力値がデータベース・ルーチンの正しいタイプではない場合、または内容が無効 (例えば最大長を超過) である場合、データベース例外が発生する可能性があります。
  9. データベース・ルーチンから返されるデータから出力エレメントへの必要なマッピングを指定します。 このデータには、OUT モードと INOUT モードのパラメーター、オプションの Routine 戻り値、および 1 つ以上の結果セットを含めることができます。 「ルーチン」出力はネストされた Return 変換の入力として表示されます。
    1. オプション: データベース・ルーチンのデータとのマージが必要な追加の入力エレメントがあれば、Return 変換に接続します。 Return 変換を、マップの 1 つ以上の出力エレメントに接続します。 指定されたデータベース・ルーチン出力値から、接続された出力を設定するため、ネストされた Return マップ内に変換を指定します。
次に行う事柄:
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        最終更新:
        
        最終更新: 2013-07-17 15:22:25


タスク・トピックタスク・トピック | IBM Integration Bus バージョン 9.0.0.0 | cm28838_