次の方法で共有

BizTalk Serverを使用して Oracle Database で REF CURSORS を使用して関数とプロシージャを呼び出す

  • [アーティクル]

REF CURSOR は、クエリを実行して生成されたサーバー側の結果セットへのポインターを表す PL/SQL データ型です。 REF CURSOR 型は、データの入出力ストリーミングを可能にし、PL/SQL コードとの間で大量のデータを転送するのに最適です。 Oracle Database アダプターは、厳密に型指定され、弱く型指定された (SYS_REFCURSOR) REF CURSOR をサポートします。これは、PL/SQL プロシージャおよび関数に IN、OUT、または IN OUT パラメーターとして渡すことができます。 Oracle データベース アダプターが REF CURSOR をサポートする方法の詳細については、「REF CURSOR パラメーターを使用した関数とプロシージャに対する操作」を参照してください。 REF CURSORS の XML 構造の詳細については、「 REF CURSORS のメッセージ スキーマ」を参照してください。

Oracle データベースで関数を呼び出す方法

BizTalk Serverを使用して Oracle データベース アダプターを使用して Oracle データベースに対して操作を実行するには、「Oracle Database を使用して BizTalk アプリケーションを開発するための構成要素」で説明されている手続き型タスクが含まれます。 パラメーターとして REF CURSOR を受け取り、REF CURSOR を out パラメーターとして指定する Oracle データベースで関数を呼び出すには、次のタスクを実行します。

  1. BizTalk プロジェクトを作成し、Oracle データベースで呼び出す関数のスキーマを生成します。

  2. Oracle データベースからメッセージを送受信するためのメッセージを BizTalk プロジェクトに作成します。

  3. Oracle データベースで関数を呼び出すオーケストレーションを作成します。

  4. BizTalk プロジェクトをビルドして展開します。

  5. 物理送受信ポートを作成して BizTalk アプリケーションを構成します。

  6. BizTalk アプリケーションを起動します。

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

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

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

スキーマの生成

このトピックでは、Oracle Database アダプターが REF CURSOR パラメーターを受け取る関数の呼び出しをどのようにサポートしているかを示すために、GET_ACTIVITY プロシージャを呼び出します。 このプロシージャは、弱く型指定された IN REF CURSOR と、厳密に型指定された IN OUT REF CURSOR をパラメーターとして受け取ります。 関数は、状態、弱く型指定された OUT REF CURSOR、および厳密に型指定された IN OUT REF CURSOR を返します。 GET_ACTIVITYプロシージャは、サンプルで提供されている SQL スクリプトを実行して作成されたACCOUNT_PKGの一部として使用できます。 サンプルと SQL スクリプトの詳細については、「 スキーマ サンプル」を参照してください。

そのため、GET_ACTIVITY プロシージャを呼び出すために、SCOTT\Package\ACCOUNT_PKG スキーマで同じプロシージャのスキーマを生成します。 スキーマの生成方法の詳細については、「 Visual Studio での Oracle Database 操作のメタデータを取得 する」を参照してください。

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

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

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

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

  1. BizTalk プロジェクトの [オーケストレーションの種類] ウィンドウを開きます (まだ表示されていない場合)。 これを行うには、[ 表示] をクリックし、[ その他のウィンドウ] をポイントして、[ オーケストレーション ビュー] をクリックします。

  2. オーケストレーション ビューで、[ メッセージ] を右クリックし、[ 新しいメッセージ] をクリックします。

  3. 新しく作成したメッセージを右クリックし、[ プロパティ ウィンドウ] を選択します。

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

    プロパティ 目的
    識別子 「 Request」と入力します。
    メッセージ型 ドロップダウン リストから [ スキーマ] を展開し、[ Func_RefCursor.OracleDBBindingSchema.GET_ACTIVITY] を選択します。 ここで、Func_RefCursor は BizTalk プロジェクトの名前です。 OracleDBBindingSchema は、GET_ACTIVITY プロシージャ用に生成されたスキーマです。

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

    プロパティ 目的
    識別子 「 応答」と入力します。
    メッセージ型 Func_RefCursor.OracleDBBindingSchema.GET_ACTIVITYResponse

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

REF CURSOR パラメーターを使用してプロシージャを呼び出すためにBizTalk Serverを使用するには、BizTalk オーケストレーションを作成する必要があります。 このオーケストレーションでは、定義された受信場所に要求メッセージをドロップします。 Oracle Database アダプターはこのメッセージを使用し、ODP を介して Oracle データベースに渡します。 Oracle データベースからの応答は別の場所に保存されます。 REF CURSOR を使用して関数とプロシージャを呼び出すための一般的なオーケストレーションには、次のものが含まれます。

  • Oracle データベースにメッセージを送信し、応答を受信する図形の送受信。

  • Oracle データベースに送信する要求メッセージを受信する一方向の受信ポート。

  • Oracle データベースに要求メッセージを送信し、応答を受信するための双方向送信ポート。

  • Oracle データベースからフォルダーに応答を送信する一方向の送信ポート。

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

    41ed9647-a49d-4122-b9fc-c5ce4dca3533Oracle

メッセージ図形の追加

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

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

ポートの追加

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

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

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

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

図形 プロパティ
ReceiveMessage - メッセージを要求に設定する
- 操作を FileIn.REFCURSOR.Request に設定する
SendMessage - メッセージを要求に設定する
- 操作を LOBPort.REFCURSOR.Request に設定する
ReceiveResponse - [メッセージ] を [応答] に設定する
- 操作を LOBPort.REFCURSOR.Response に設定する
SendResponse - [メッセージ] を [応答] に設定する
- 操作を SaveResponse.REFCURSOR.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 受信場所に要求メッセージをドロップする必要があります。 要求メッセージのスキーマは、前に生成したプロシージャのスキーマに準拠している必要があります。 Oracle Database アダプターを使用して関数を呼び出すための要求メッセージ スキーマの詳細については、「 関数とプロシージャ のメッセージ スキーマ」を参照してください。

GET_ACTIVITY プロシージャを呼び出すには、弱く型指定された IN REF CURSOR と厳密に型指定された IN OUT REF CURSOR をパラメーターとして指定する必要があります。 そのため、このプロシージャを呼び出す要求メッセージは次のようになります。

<GET_ACTIVITY xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG">  
  <INRECS>BEGIN OPEN ? FOR SELECT * FROM ACCOUNTACTIVITY WHERE ACCOUNT=100001; END;</INRECS>  
  <INOUTRECS_IN>BEGIN ACCOUNT_PKG.GET_ALL_ACTIVITY(?); END;</INOUTRECS_IN>  
</GET_ACTIVITY>

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

上記の要求メッセージの応答は次のとおりです。

<?xml version="1.0" encoding="utf-8" ?>   
<GET_ACTIVITYResponse xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG">  
  <STATUS>5</STATUS>   
  <INOUTRECS>  
    <INOUTRECSRECORD xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG/GET_ACTIVITY">  
      <TID>1</TID>   
      <ACCOUNT>100001</ACCOUNT>   
      <AMOUNT>500</AMOUNT>   
      <DESCRIPTION />   
      <TRANSDATE>2007-10-16T16:58:44</TRANSDATE>   
      <PROCESSED>n</PROCESSED>   
    </INOUTRECSRECORD>  
    <INOUTRECSRECORD xmlns="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Package/ACCOUNT_PKG/GET_ACTIVITY">  
      .....   
      .....   
    </INOUTRECSRECORD>  
    ....  
    ....  
  </INOUTRECS>  
  <OUTRECS>  
    <GenRecordRow xmlns="http://Microsoft.LobServices.OracleDB/2007/03">  
      <GenRecordColumn>  
        <GenRecordColumn>  
          <ColumnName>TID</ColumnName>   
          <ColumnValue>1</ColumnValue>   
          <ColumnType>System.Decimal</ColumnType>   
        </GenRecordColumn>  
        <GenRecordColumn>  
          ....   
        </GenRecordColumn>  
        .....  
        .....  
      </GenRecordColumn>  
    </GenRecordRow>  
    <GenRecordRow xmlns="http://Microsoft.LobServices.OracleDB/2007/03">  
      .....  
      .....  
    </GenRecordRow>  
    .....  
    .....  
  </OUTRECS>  
</GET_ACTIVITYResponse>

応答には、状態、弱く型指定された OUT REF CURSOR、および厳密に型指定された IN OUT REF CUROSR が含まれていることに注意してください。

考えられる例外

BizTalk Serverを使用して関数とプロシージャを呼び出すときに発生する可能性がある例外については、「例外とエラー処理」を参照してください。

ベスト プラクティス

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

参照

BizTalk アプリケーションの開発