SQL アダプターでBizTalk Serverを使用して操作を挿入、更新、削除、または選択する

[アーティクル]
10/14/2023

microsoft BizTalk Adapter for SQL Serverでは、SQL Serverデータベーステーブルとビューに対する一連の標準操作が表示されます。これらは、データ操作言語 (DML) 操作と呼ばれます。 DML 操作を使用すると、テーブルとビューに対して簡単な挿入、更新、選択、および削除操作を実行できます。アダプターがこれらの操作をサポートする方法の詳細については、「SQL アダプターを使用したテーブルとビューに対する挿入、更新、削除、および選択操作」を参照してください。これらの操作の SOAP メッセージの構造については、「テーブルとビューに対する挿入、更新、削除、および選択操作のメッセージスキーマ」を参照してください。

Note

ユーザー定義型の列を持つテーブルに対して操作を実行する場合は、アプリケーションの開発を開始する前に、「SQL アダプターを使用して User-Defined 型を持つテーブルとビューに対する操作」を参照してください。

SQL Server データベースに対して基本的な操作を実行する方法

BizTalk Serverと共に SQL アダプターを使用してSQL Server データベースに対して操作を実行するには、「Sql アダプターを使用して BizTalk アプリケーションを開発するための構成要素」で説明されている手続き型タスクが含まれます。 SQL Serverのテーブルとビューに対して挿入、更新、削除、または選択操作を実行するには、次のタスクを実行します。

BizTalk プロジェクトを作成し、SQL Server データベーステーブルまたはビューで呼び出す操作のスキーマを生成します。
SQL Server データベースからメッセージを送受信するためのメッセージを BizTalk プロジェクトに作成します。
SQL Server データベーステーブルまたはビューで操作を呼び出すオーケストレーションを作成します。
BizTalk プロジェクトをビルドして展開します。
物理送受信ポートを作成して BizTalk アプリケーションを構成します。
BizTalk アプリケーションを起動します。

このトピックでは、これらのタスクを実行する手順について説明します。

このトピックに基づくサンプル

このトピックに基づく SelectTable のサンプルは、BizTalk アダプターパックで提供されています。詳細については、「 SQL アダプターのサンプル」を参照してください。

スキーマの生成

このトピックでは、SQL Server データベースの EMPLOYEE テーブルからレコードを選択して、基本的な DML 操作を実行する方法について説明します。サンプルに付属のスクリプトを実行して、EMPLOYEE テーブルを作成します。サンプルの詳細については、「スキーマサンプル」を参照してください。

レコードを選択する方法を示すために、EMPLOYEE テーブルの Select 操作のスキーマが生成されます。 BizTalk プロジェクトを作成し、アダプターサービスアドインを使用してスキーマを生成する必要があります。スキーマの生成方法の詳細については、「SQL アダプターを使用した Visual Studio でのSQL Server操作のメタデータの取得」を参照してください。

重要

ユーザー定義型 (UDT) の列を持つテーブルに対する操作のメタデータを生成する場合は、UDT のそれぞれのアセンブリが Visual Studio 実行可能ファイルと同じ場所 devenv.exe 使用できることを確認します。実行可能ファイルは通常、で <installation drive>:\Program Files\Microsoft Visual Studio <version>\Common7\IDE使用できます。この例では、EMPLOYEE テーブルに UDT (Point) 列があります。それぞれのアセンブリを Visual Studio 実行可能ファイルと同じ場所にコピーしてください。

UDT を作成する方法については、「 User-Defined 型を作成する」を参照してください。 SQL Serverで UDT を登録する方法については、「SQL Serverでの User-Defined 型の登録」を参照してください。

メッセージとメッセージの種類の定義

先に生成したスキーマは、オーケストレーションのメッセージに求められる "型" を記述します。メッセージは通常、対応するスキーマによって定義された型の変数です。オーケストレーションのメッセージを作成し、前の手順で生成したスキーマにリンクする必要があります。

BizTalk プロジェクトにオーケストレーションを追加します。ソリューションエクスプローラーから BizTalk プロジェクト名を右クリックし、[追加] をポイントして、[新しい項目] をクリックします。 BizTalk オーケストレーションの名前を入力し、[ 追加] をクリックします。
BizTalk プロジェクトの [オーケストレーションの種類] ウィンドウを開きます (まだ表示されていない場合)。これを行うには、[ 表示] をクリックし、[ その他のウィンドウ] をポイントして、[ オーケストレーションビュー] をクリックします。
オーケストレーションビューで、[ メッセージ] を右クリックし、[ 新しいメッセージ] をクリックします。
新しく作成したメッセージを右クリックし、[ プロパティウィンドウ] を選択します。

Message_1の [プロパティ] ウィンドウで、次の操作を行います。

プロパティ	目的
識別子	「`Request`」と入力します
メッセージ型	ドロップダウンリストから [ スキーマ] を展開し、[ SelectTable.TableOperation_dbo_Employee.Select] を選択します。ここで、SelectTable は BizTalk プロジェクトの名前です。 TableOperation_dbo_Employeeは、EMPLOYEE テーブルの Select 操作に対して生成されるスキーマです。

手順 2 を繰り返して、新しいメッセージを作成します。新しいメッセージの [プロパティ ] ウィンドウで、次の操作を行います。

プロパティ	目的
識別子	「`Response`」と入力します
メッセージ型	ドロップダウンリストから [ スキーマ] を展開し、[ SelectTable.TableOperation_dbo_Employee.SelectResponse] を選択します。

オーケストレーションの設定

SQL Serverで操作を実行するためにBizTalk Serverを使用するには、BizTalk オーケストレーションを作成する必要があります。このオーケストレーションでは、定義された受信場所に要求メッセージをドロップします。 SQL アダプターはこのメッセージを使用し、SQL Serverに渡します。 SQL Serverからの応答は別の場所に保存されます。 SQL Serverにメッセージを送信したり、応答を受信したりするには、[送信] 図形と [受信] 図形を含める必要があります。 Select 操作のサンプルオーケストレーションは次のようになります。

e74e342f-ba66-41fe-bd34-d45cd8767ef8 SQL Server での

メッセージ図形の追加

メッセージ図形ごとに次のプロパティを指定してください。 [図形] 列に一覧表示される名前は、単一のオーケストレーションに表示されるメッセージ図形の名前です。

図形	図形の種類	プロパティ
ReceiveMessage	受信	- 名前を ReceiveMessage に設定する - Activate をTrue に設定する
SendMessage	Send	- 名前を SendMessage に設定する
ReceiveResponse	受信	- 名前を ReceiveResponse に設定する - Activate をFalse に設定する
SendResponse	Send	- 名前を SendResponse に設定する

ポートの追加

論理ポートごとに次のプロパティを指定してください。 [ポート] 列に表示される名前は、オーケストレーションに表示されるポートの名前です。

Port	プロパティ
MessageIn	- 識別子を MessageIn に設定する - 型を MessageInType に設定する - 通信パターンを一方向に設定する - 通信方向を受信に設定する
LOBPort	- 識別子を LOBPort に設定する - 型を LOBPortType に設定する - 通信パターンを Request-Response に設定する - [通信の方向] を [送受信] に設定する
ResponseOut	- 識別子を ResponseOut に設定する - Type を ResponseOutType に設定する - 通信パターンを一方向に設定する - [通信の方向] を [送信] に設定する

アクション図形のメッセージを指定し、ポートに接続する

次の表では、アクション図形のメッセージを指定し、メッセージをポートにリンクするために設定するプロパティとその値を指定します。 [図形] 列に表示される名前は、前述のオーケストレーションに表示されるメッセージ図形の名前です。

図形	プロパティ
ReceiveMessage	- メッセージを要求に設定する - 操作を MessageIn.Select.Request に設定する
SendMessage	- メッセージを要求に設定する - 操作を LOBPort.Select.Request に設定する
ReceiveResponse	- メッセージを応答に設定する - 操作を LOBPort.Select.Response に設定する
SendResponse	- メッセージを応答に設定する - 操作を ResponseOut.Select.Request に設定する

これらのプロパティを指定すると、メッセージの図形とポートが接続され、オーケストレーションが完了します。

BizTalk ソリューションをビルドし、BizTalk Serverに展開する必要があります。詳細については、「オーケストレーションのビルドと実行」を参照してください。

BizTalk アプリケーションの構成

BizTalk プロジェクトを展開すると、先ほど作成したオーケストレーションが、BizTalk Server管理コンソールの [オーケストレーション] ウィンドウの下に一覧表示されます。アプリケーションを構成するには、BizTalk Server管理コンソールを使用する必要があります。チュートリアルについては、「チュートリアル: 基本的な BizTalk アプリケーションの展開」を参照してください。

アプリケーションの構成には、次の作業が含まれます。

アプリケーションのホストの選択。
オーケストレーションで作成したポートを、BizTalk Server管理コンソールの物理ポートにマッピングします。このオーケストレーションでは、次の操作を行う必要があります。
- ハードディスク上の場所と、要求メッセージをドロップする対応するファイルポートを定義します。 BizTalk オーケストレーションは要求メッセージを使用し、SQL Server データベースに送信します。
- ハードディスク上の場所と、BizTalk オーケストレーションがSQL Server データベースからの応答を含む応答メッセージを削除する対応するファイルポートを定義します。
- SQL Server データベースにメッセージを送信する物理 WCF-Custom または WCF-SQL 送信ポートを定義します。また、送信ポートでアクションを指定する必要があります。ポートを作成する方法については、「 SQL アダプターへの物理ポートバインドを手動で構成する」を参照してください。
  
  Note
  
  アダプターサービス BizTalk プロジェクトアドインを使用してスキーマを生成すると、ポートに関する情報と、それらのポートに設定するアクションを含むバインドファイルも作成されます。 BizTalk Server管理コンソールからこのバインドファイルをインポートして、送信ポート (送信呼び出しの場合) または受信ポート (受信呼び出し用) を作成できます。詳細については、「 SQL アダプターを使用するようにポートバインドファイルを使用して物理ポートバインドを構成する」を参照してください。

アプリケーションの起動

SQL Server データベーステーブルからレコードを選択するには、BizTalk アプリケーションを起動する必要があります。 BizTalk アプリケーションを起動する手順については、「オーケストレーションを開始する方法」を参照してください。

この段階で、次のことを確認します。

オーケストレーションの要求メッセージを受信する FILE 受信ポートが実行されています。
オーケストレーションからの応答メッセージを受信する FILE 送信ポートが実行されています。
SQL Server データベースにメッセージを送信する WCF-Custom または WCF-SQL 送信ポートが実行されています。
操作の BizTalk オーケストレーションが実行されています。

重要

ユーザー定義型 (UDT) の列があるテーブルに対して操作を実行する場合は、UDT のそれぞれのアセンブリが、BizTalk Server実行可能ファイルと同じ場所で使用できることを確認 btsntsvc.exe。実行可能ファイルは通常、で <installation drive>:\Program Files\Microsoft BizTalk Server <version>使用できます。この例では、EMPLOYEE テーブルに UDT (Point) 列があります。それぞれのアセンブリを、BizTalk Server実行可能ファイルと同じ場所にコピーしてください。

UDT を作成する方法については、「 User-Defined 型の作成」を参照してください。 SQL Serverで UDT を登録する方法については、「SQL Serverで User-Defined 型を登録する」を参照してください。

操作の実行

アプリケーションを実行した後、FILE 受信場所に要求メッセージをドロップする必要があります。要求メッセージのスキーマは、前に生成した Select 操作のスキーマに準拠している必要があります。たとえば、EMPLOYEE テーブルからすべてのレコードを選択するための要求メッセージは次のとおりです。

<Select xmlns="http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/Employee">  
  <Columns>*</Columns>  
  <Query>where Employee_ID=10001</Query>  
</Select>

この要求メッセージは、要素で <Query> 指定された条件を満たすレコードを Employee テーブルから取得します。テーブルから特定の列を取得する場合は、テーブル定義に表示されるのと同じ順序で <> Columns 要素をコンマで区切って指定する必要があります。データを取得する条件を指定しない場合は、要素を <Query> 空白のままにします。 SQL アダプターを使用してデータベーステーブルとビューに対して基本的な DML 操作を実行するための要求メッセージスキーマの詳細については、「挿入、更新、削除、およびテーブルとビューに対する操作の選択」を参照SQL Server。

オーケストレーションはメッセージを使用し、SQL Serverデータベースに送信します。 SQL Server データベースからの応答は、オーケストレーションの一部として定義されている他の FILE の場所に保存されます。たとえば、上記の要求メッセージSQL Serverデータベースからの応答は次のようになります。

<?xml version="1.0" encoding="utf-8" ?>   
<SelectResponse xmlns="mssql://Microsoft.LobServices.Sql/2008/01/TVOp/dbo/Employee">  
  <SelectResult>  
    <Employee xmlns="mssql://Microsoft.LobServices.Sql/2008/01/Types/Tables/dbo">  
      <Employee_ID>10001</Employee_ID>  
      <Name>John</Name>  
      <DOJ>1983-12-31T00:00:00Z</DOJ>  
      <Designation>Manager</Designation>  
      <Job_Description>Management</Job_Description>  
      <Photo>EjRVYzRFVQ==</Photo>  
      <Rating>1,2</Rating>  
      <Salary>100000.00</Salary>  
      <Last_Modified>AAAAAAAAD6I=</Last_Modified>  
    </Employee>  
  </SelectResult>  
</SelectResponse>

ベストプラクティス

BizTalk プロジェクトを展開して構成したら、バインドファイルと呼ばれる XML ファイルに構成設定をエクスポートできます。バインドファイルを生成したら、ファイルから構成設定をインポートして、同じオーケストレーションの送信ポートや受信ポートなどの項目を作成する必要がないようにすることができます。バインドファイルの詳細については、「 SQL アダプターバインドの再利用」を参照してください。
大量のデータを挿入、更新、または削除する場合は、WCF アダプターと MSDTC トランザクションに適切なタイムアウト値を設定してください。詳細については、「SQL アダプターの操作上の問題のトラブルシューティング」の「BizTalk Serverを使用して、アダプターが 1 回の操作で大量のデータを挿入、更新、または削除できない」を参照してください。

参照

SQL アダプターを使用して BizTalk アプリケーションを開発する

次の方法で共有

SQL アダプターでBizTalk Serverを使用して操作を挿入、更新、削除、または選択する

SQL Server データベースに対して基本的な操作を実行する方法

このトピックに基づくサンプル

スキーマの生成

メッセージとメッセージの種類の定義

オーケストレーションの設定

メッセージ図形の追加

ポートの追加

アクション図形のメッセージを指定し、ポートに接続する

BizTalk アプリケーションの構成

アプリケーションの起動

操作の実行

ベストプラクティス

参照

フィードバック

フィードバック

その他のリソース

次の方法で共有

SQL アダプターでBizTalk Serverを使用して操作を挿入、更新、削除、または選択する

SQL Server データベースに対して基本的な操作を実行する方法

このトピックに基づくサンプル

スキーマの生成

メッセージとメッセージの種類の定義

オーケストレーションの設定

メッセージ図形の追加

ポートの追加

アクション 図形のメッセージを指定し、ポートに接続する

BizTalk アプリケーションの構成

アプリケーションの起動

操作の実行

ベスト プラクティス

参照

フィードバック

フィードバック

その他のリソース

アクション図形のメッセージを指定し、ポートに接続する

ベストプラクティス