次の方法で共有

BizTalk Adapter for DB2 の構成 - HIS

概要

Microsoft BizTalk Adapter for DB2 は、Ibm メインフレーム DB2 for z/OS、IBM midrange DB2 for IBM i、および Linux、UNIX、および Windows オペレーティング システムで実行されている IBM Server DB2 に格納されている重要なデータに BizTalk Server を接続します。 このアダプターは、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 データベースへの接続に使用される接続文字列の名前。

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

    ヘルプにアクセスするには、ウィザード ページの [ヘルプ ] をクリックするか、Host Integration Server ヘルプを開き、 データ ソース ウィザード (DB2) を参照します。
    DB2 レジスター設定 DB2 Set Registers プロパティは、1 つ以上の SQL SET ステートメントを実行するようにアダプターに指示します。 この省略可能なプロパティは、 文字列 値を受け入れます。 既定値は 空の文字列で、ステートメントがないことを示します。 サポートされている構文は、SET ステートメントコマンドがセミコロンで区切られ、それぞれのコマンドにはコンマで区切られたSETステートメント値のリストが続きます（例: "<SET コマンド 1><SET 値 1> セミコロン; <SET コマンド 2><SET 値 a>、<SET 値 b> セミコロン”）。 たとえば、「SET CURRENT PATH 'DSN8910', 'HISDEMO'」と入力します。
    ドキュメント ターゲット名前空間 DB2 に送信される XML ドキュメントで使用されるターゲット名前空間。
    応答ルート要素名 DB2 から受け取る XML ドキュメントで使用されるルート要素名。 (一方向ポートの場合、このプロパティは空の場合があります)。
    URI 統一リソース識別子（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 データベースへの接続に使用する接続文字列の名前を入力します。

    新規または既存の接続文字列を構成するには、省略記号 (...) をクリックします。 データ ソース ウィザードが起動します。 ヘルプにアクセスするには、ウィザード ページの [ヘルプ ] をクリックするか、Host Integration Server ヘルプを開き、 データ ソース ウィザード (DB2) を参照します。
    DB2 レジスター設定 DB2 Set Registers プロパティは、1 つ以上の SQL SET ステートメントを実行するようにアダプターに指示します。 この省略可能なプロパティは、文字列値を受け入れます。 既定値は空の文字列で、ステートメントがないことを示します。 サポートされている構文は、SET ステートメントコマンドがセミコロンで区切られ、それぞれのコマンドにはコンマで区切られたSETステートメント値のリストが続きます（例: "<SET コマンド 1><SET 値 1> セミコロン; <SET コマンド 2><SET 値 a>、<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. [完了] を選択してウィザードを完了します。

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