BizTalk Adapter for DB2 構成 - HIS

  • [アーティクル]

概要

Microsoft BizTalk Adapter for DB2 は、BizTalk Serverを IBM メインフレーム DB2 for z/OS、IBM midrange DB2 for IBM i、および Linux、UNIX、および Windows オペレーティング システムで実行されている IBM サーバー DB2 に格納されている重要なデータに接続します。 アダプターは Microsoft ADO.NET Data Provider for DB2 に基づいており、SNA および TCP/IP ネットワーク接続を介した分散トランザクションを使用した送信ポートや受信ポートなど、幅広い機能をサポートしています。 IT プロフェッショナルは、ポート構成ウィザード内で定義された SQL コマンドを使用して、コードを記述することなく、DB2 データベースを効率的に統合するソリューションを簡単に作成できます。

アダプターは、次の 2 つのメイン機能を提供します。

  • 送信操作 (One Way と Solicit Response の両方) の場合、アダプターは SQL コマンドとストアド プロシージャを DB2 インスタンスに送信し、応答を要求するオプションを指定します。

  • 受信操作 (一方向のみ) の場合、アダプターは DB2 オブジェクトをポーリングし、行ごとのメッセージを作成する SQL コマンドまたはストアド プロシージャを作成し、BizTalk メッセージ システムに送信します。

    さらに、BizTalk Adapter for DB2 では、トラブルシューティング メカニズムとして標準の BizTalk アダプター トレース ツールが使用されます。

DB2 送信ポートを作成する

BizTalk Server Administrators グループのメンバーであるアカウントでサインインします。

  1. [BizTalk Server管理] で、[BizTalk グループ] を展開し、[アプリケーション] を展開して、アプリケーションを選択します。

  2. [ 送信ポート] を右クリックし、[ 新規] を選択し、[ 静的一方向送信ポート] を選択します。

  3. [ 送信ポートのプロパティ] で、[ トランスポートの種類] を [DB2] に設定します。 [ 構成] を選択し、次のプロパティを入力します。

    プロパティ 目的
    BulkCopyBatchSize BulkCopyBatchSize プロパティは、バッチ トランザクションごとに処理する行数をアダプターに指示します。 この 省略可能な プロパティ は整数値を 受け取ります。 既定値は 20 です。 値 0 は、1 つのバッチ内のすべての行を処理するようにアダプターに指示します。
    CommandTimeOut CommandTimeout プロパティは、アダプターがコマンドの実行試行を終了してからエラーを生成するまでの待機時間を設定します。 この 省略可能な プロパティ は整数値を 受け取ります。 既定値は 30 秒です。 値 0 は制限がないことを示します (コマンドを実行しようとすると無期限に待機します)。
    接続文字列 DB2 データベースへの接続に使用される接続文字列の名前。

    新規または既存の接続文字列を構成するには、省略記号 (...) をクリックします。 これにより、データ ソース ウィザードが起動します。

    ヘルプにアクセスするには、ウィザード ページの [ヘルプ ] をクリックするか、ホスト統合サーバーのヘルプを開き、 データ ソース ウィザード (DB2) を確認します。
    DB2 Set Registers DB2 Set Registers プロパティは、1 つ以上の SQL SET ステートメントを実行するようにアダプターに指示します。 この省略可能なプロパティは 、文字列 値を受け入れます。 既定値は 空の文字列で、ステートメントがないことを示します。 サポートされている構文は、SET ステートメント値のコンマ区切りリストを含む SET ステートメント・コマンドのセミコロン区切りリストです。<SET コマンド 1> スペース <SET 値 1> セミコロン。 <SET コマンド 2> スペース <SET 値に> コンマ <SET 値 b> セミコロン")。 たとえば、「SET CURRENT PATH 'DSN8910', 'HISDEMO'」と入力します。
    [ドキュメントのターゲットの名前空間] DB2 に送信される XML ドキュメントで使用されるターゲット名前空間。
    [応答のルート要素名] DB2 から受け取る XML ドキュメントで使用されるルート要素名。 (このプロパティは、一方向ポートでは空である可能性があります)。
    URI 均一なリソース識別子。 送信ポートの場所を識別する名前。 既定値は DB2://です。
    UseBulkCopy UseBulkCopy プロパティは、一括コピー モードで送信ポート INSERT コマンドを処理してパフォーマンスを向上するようにアダプターに指示します。 この 省略可能な プロパティは、 ブール 値を受け入れます。 既定値は false です。

  4. [OK] を選択して変更を保存します。

  5. [送信ハンドラー] で、アダプターを実行するホスト インスタンスを選択し、[送信パイプライン] を選択します。

  6. [OK] を選択して変更を保存します。

  7. [ 送信ポート] で、新しい送信ポートを右クリックし、[ 参加 ] を選択し、[開始] を選択 します。

DB2 受信ポートを作成する

BizTalk Server Administrators グループのメンバーであるアカウントでサインインします。

  1. [BizTalk Server管理] で、[BizTalk グループ] を展開し、[アプリケーション] を展開して、アプリケーションを選択します。

  2. [ 受信ポート] を右クリックし、[ 新規] を選択し、[ 一方向の受信ポート] を選択します。 プロパティを構成し、[ OK] を選択します。

  3. [ 受信場所] を右クリックし、[ 新規] を選択し、[ 一方向の受信場所] を選択します。 先ほど作成した受信ポートを選択し、[OK] をクリック します。

  4. [ 受信場所のプロパティ] で、 トランスポートの種類 を DB2 に設定します。 [ 構成] を選択し、次のプロパティを入力します。

    プロパティ 目的
    CommandTimeOut CommandTimeout プロパティは、アダプターがコマンドの実行試行を終了してからエラーを生成するまでの待機時間を設定します。 このオプションのプロパティでは、整数値を使用できます。 既定値は 30 秒です。 値 0 は制限がないことを示します (コマンドを実行しようとすると無期限に待機します)。
    接続文字列 DB2 データベースへの接続に使用する接続文字列の名前を入力します。

    新規または既存の接続文字列を構成するには、省略記号 (...) をクリックします。 これにより、データ ソース ウィザードが起動します。 ヘルプにアクセスするには、ウィザード ページの [ヘルプ ] をクリックするか、ホスト統合サーバーのヘルプを開き、 データ ソース ウィザード (DB2) を確認します。
    DB2 Set Registers DB2 Set Registers プロパティは、1 つ以上の SQL SET ステートメントを実行するようにアダプターに指示します。 このオプションのプロパティでは、文字列値を使用できます。 既定値は空の文字列で、ステートメントがないことを示します。 サポートされている構文は、SET ステートメント値のコンマ区切りリストを含む SET ステートメント・コマンドのセミコロン区切りリストです。<SET コマンド 1> スペース <SET 値 1> セミコロン。 <SET コマンド 2> スペース <SET 値に> コンマ <SET 値 b> セミコロン")。 たとえば、「SET CURRENT PATH 'DSN8910', 'HISDEMO'」と入力します。
    [ドキュメントのルート要素名] DB2 から受け取る XML ドキュメントで使用されるルート要素名。
    [ドキュメントのターゲットの名前空間] DB2 から受け取る XML ドキュメントで使用されるターゲット名前空間。
    SQL コマンド ポーリング間隔ごとに 1 回実行される select またはストアド プロシージャ コマンド。
    Update コマンド 受信操作の各行が処理された後に実行されるコマンド。 SQL コマンドのテーブルから行を削除する delete ステートメント、または 1 つ以上の行を静的に変更する更新コマンドを指定できます。 このオプションを指定する場合、SQL コマンドは Select ステートメントであり、1 つのテーブルにアクセスする必要があります。
    URI 受信ポートの場所を識別する名前。 既定値は DB2://です。
    ポーリング間隔 ポーリング要求間のユニット数。 使用できる範囲は 1 から 65535 です。
    [ポーリング単位] ポーリング要求間で使用される測定単位 (秒、分、または時間)。 既定値は秒です。

  5. [OK] を選択して変更を保存します。

  6. [受信ハンドラー] で、アダプターを実行するホスト インスタンスを選択します。 受信ハンドラーは、このホストで実行される必要があります。 [受信パイプライン] を選択します。 . [OK] を選択して変更を保存します。

  7. [ 受信場所] で、受信場所を右クリックし、[ 有効にする] をクリックします。

DB2 アダプター スキーマを作成する

  1. BizTalk Visual Studio プロジェクトを開きます。

  2. プロジェクトを右クリックし、[ 追加] を選択し、[ 生成された項目の追加] を選択して、[ 追加] を選択します。

  3. [ 生成された項目の追加 ] ダイアログ ボックスで、[ アダプター メタデータの追加] を選択します。

  4. アダプターの追加ウィザードの [アダプターの 選択 ] ページで、[ DB2] を選択します。 [ポート] ボックスの一覧で、構成された送信ポートまたは受信場所を選択し、[ 次へ] を選択します。

  5. DB2 アダプター スキーマ生成ウィザードで、次の操作を行います。

    1. [データベース情報] で、接続文字列を作成するか、既存の接続文字列を選択します。

    2. [ スキーマ情報] で、スキーマで使用する既定の名前空間、ルート要素、およびポートの種類を定義します。

      [受信ポート] を選択した場合は、要求ドキュメントのルート要素名のみが必要です。 [ポートの 送信] を選択した場合は、要求と応答の両方のドキュメントルート要素名が必要です。

    3. [ ステートメントの種類情報] で、発行するデータベース コマンドの種類を選択します。

      前のページで [受信ポート] を選択した場合は、SELECT SQL ステートメントまたはストアド プロシージャのいずれかを選択できます。 前のページで [送信ポート] を選択した場合は、アップデートグラム、ストアド プロシージャ、または SELECT ステートメントを発行することを選択できます。

    4. [ ステートメント情報] に、DB2 データベースの詳細を入力します。 前に入力した情報に応じて、次のプロパティを使用できます。

      1. [ステートメント情報] ダイアログで Select ステートメントを受け取り、[SQL スクリプト] 編集ボックスに SQL SELECT ステートメントを入力します。 必要に応じて、[ 参照 ] をクリックして、ステートメントを含むテキスト ファイルを読み込みます。

      2. [ステートメント情報] ダイアログでストアド プロシージャを受け取り、ストアド プロシージャ名をクリックします。 [パラメーター] ボックスの一覧で、必要な各パラメーターの [ 値 ] チェック ボックスをオンにします。

      3. [ステートメント情報] ダイアログでアップデートグラムを送信し、テーブル名をクリックします。 [ パラメーター ] ボックスの一覧で、必要な各列の [ 値 ] チェック ボックスをオンにします。 BulkCopy を使用する場合は、各 [値] チェック ボックスをオンにしてすべての列を選択する必要があります。

      4. [ステートメント情報] ダイアログでストアド プロシージャを送信し、ストアド プロシージャ名をクリックします。 [ パラメーター ] ボックスの一覧で、必要な各パラメーターの [ 値 ] チェック ボックスをオンにします。

      5. ステートメントの [情報] ダイアログで Select ステートメントを送信し、[SQL スクリプト] 編集ボックスに「SQL SELECT ステートメント」と入力します。 必要に応じて、[ 参照 ] をクリックして、ステートメントを含むテキスト ファイルを読み込みます。

  6. [ 完了] を選択 してウィザードを完了します。

これでスキーマが作成されました。