Oracle Database でBizTalk Serverを使用して操作を挿入、更新、削除、または選択する

[アーティクル]
05/04/2023

Microsoft BizTalk Adapter for Oracle Database では、Oracle データベースのテーブルとビューに対する一連の標準操作が表示されます。これらは、テーブルとビューに対して WHERE 句によって修飾された単純な INSERT、UPDATE、SELECT、DELETE ステートメントを実行できる、データ操作言語操作 (DML) 操作と呼ばれます。アダプターがこれらの操作をサポートする方法の詳細については、「 Oracle テーブルとビューに対する挿入、更新、削除、および選択操作」を参照してください。 DML 操作の SOAP メッセージの構造については、「テーブルとビューに対する基本的な挿入、更新、削除、および選択操作のメッセージスキーマ」を参照してください。

Note

パラメーター化された SQL SELECT クエリの実行など、より複雑な操作を実行するには、SQLEXECUTE 操作を使用します。 BizTalk Serverで SQLEXECUTE 操作を使用する方法の詳細については、「BizTalk Serverを使用して SQLEXECUTE 操作を実行する」を参照してください。

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

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

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

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

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

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

スキーマの生成

このトピックでは、基本的な DML 操作を実行する方法を示すために、Oracle データベースの SCOTT スキーマの下にある ACCOUNTACTIVITY テーブルからレコードを選択します。このテーブルは、サンプルで提供されている SQL スクリプトを実行して、SCOTT スキーマの下に作成されます。サンプルの詳細については、「アダプターのサンプル」を参照してください。

レコードを選択する方法を示すために、SCOTT スキーマの下にある ACCOUNTACTIVITY テーブルの Select 操作のスキーマを生成します。スキーマの生成方法の詳細については、「 Visual Studio での Oracle Database 操作のメタデータを取得する」を参照してください。

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

前に生成したスキーマでは、オーケストレーション内のメッセージに必要な "型" について説明します。通常、メッセージは変数であり、対応するスキーマによって定義される型です。最初の手順で生成したスキーマを、BizTalk プロジェクトの [オーケストレーションビュー] ウィンドウからメッセージにリンクする必要があります。

このトピックでは、2 つのメッセージを作成する必要があります。1 つは Oracle データベースに要求を送信し、もう 1 つは応答を受信するメッセージです。

メッセージを作成し、スキーマにリンクするには、次の手順を実行します。

メッセージを作成し、スキーマにリンクするには

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

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

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

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

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

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

Oracle データベースで操作を実行するためにBizTalk Serverを使用するには、BizTalk オーケストレーションを作成する必要があります。このオーケストレーションでは、定義された受信場所に要求メッセージをドロップします。 Oracle Database アダプターはこのメッセージを使用し、ODP を介して Oracle データベースに渡します。 Oracle データベースからの応答は、別の場所に保存されます。 Oracle データベースで基本的なテーブル操作を実行するための一般的なオーケストレーションには、次のものが含まれます。

Oracle データベースにメッセージを送信し、応答を受信する図形を送受信します。
Oracle データベースに送信する要求メッセージを受信する一方向の受信ポート。
Oracle データベースに要求メッセージを送信し、応答を受信する双方向送信ポート。
Oracle データベースからフォルダーに応答を送信する一方向送信ポート。

Select 操作のサンプルオーケストレーションは、次のようになります。

Oracle での

メッセージ図形の追加

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

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

ポートの追加

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

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

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

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

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

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

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

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

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

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

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

アプリケーションの起動

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

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

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

操作の実行

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

<Select xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/ACCOUNTACTIVITY">  
  <COLUMN_NAMES>*</COLUMN_NAMES>  
  <FILTER>ACCOUNT=100001</FILTER>  
</Select>

Oracle データベースアダプターを使用して Oracle データベーステーブルとビューに対して基本的な DML 操作を実行するための要求メッセージスキーマの詳細については、「テーブルとビューに対する基本的な挿入、更新、削除、および選択操作のメッセージスキーマ」を参照してください。

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

<?xml version="1.0" encoding="utf-8" ?>   
  <SelectResponse xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/ACCOUNTACTIVITY">  
    <SelectResult>  
      <ACCOUNTACTIVITYRECORDSELECT>  
        <TID>1</TID>   
        <ACCOUNT>100001</ACCOUNT>   
        <AMOUNT>500</AMOUNT>   
        <DESCRIPTION />   
        <TRANSDATE>2007-10-16T16:58:44</TRANSDATE>   
        <PROCESSED>n</PROCESSED>   
        </ACCOUNTACTIVITYRECORDSELECT>  
      <ACCOUNTACTIVITYRECORDSELECT>  
        ….   
        ….  
      <ACCOUNTACTIVITYRECORDSELECT>  
      ….  
      ….    
    </SelectResult>  
  </SelectResponse>

考えられる例外

BizTalk Serverを使用した DML 操作の実行中に発生する可能性がある例外については、「例外とエラー処理」を参照してください。

ベストプラクティス

BizTalk プロジェクトを展開して構成したら、バインドファイルと呼ばれる XML ファイルに構成設定をエクスポートできます。バインドファイルを生成したら、同じオーケストレーションに対して送信ポートや受信ポートなどを作成する必要がないように、ファイルから構成設定をインポートできます。バインドファイルの詳細については、「 Oracle データベースアダプターのバインドを再利用する」を参照してください。

参照

Oracle データベースアプリケーションの開発

Oracle Database でBizTalk Serverを使用して操作を挿入、更新、削除、または選択する

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

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

スキーマの生成

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

メッセージを作成し、スキーマにリンクするには

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

メッセージ図形の追加

ポートの追加

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

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

アプリケーションの起動

操作の実行

考えられる例外

ベストプラクティス

参照

フィードバック

フィードバック

その他のリソース

Oracle Database でBizTalk Serverを使用して操作を挿入、更新、削除、または選択する

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

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

スキーマの生成

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

メッセージを作成し、スキーマにリンクするには

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

メッセージ図形の追加

ポートの追加

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

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

アプリケーションの起動

操作の実行

考えられる例外

ベスト プラクティス

参照

フィードバック

フィードバック

その他のリソース

ベストプラクティス