REF CURSOR 是 PL/SQL 資料類型，代表執行查詢所產生的伺服器端結果集指標。 REF CURSOR 類型可啟用資料的輸入和輸出串流，非常適合用來在 PL/SQL 程式代碼中傳輸大量數據。 Oracle Database 配接器支援強型別和弱型別的 REF CURSOR（SYS_REFCURSOR），可以作為 IN、OUT 或 IN OUT 參數傳遞到 PL/SQL 程式和函式。 如需 Oracle 資料庫配接器如何支援 REF CURSOR 的詳細資訊，請參閱 使用 REF CURSOR 參數的函式和程式上的作業。 如需 REF CURSORS XML 結構的相關信息，請參閱 REF CURSORS 的訊息架構。
如何在 Oracle 資料庫中叫用函式？
搭配 BizTalk Server 使用 Oracle 資料庫配接器在 Oracle 資料庫上執行作業牽涉到建置組塊中所述的程式性工作 ，以使用 Oracle Database 開發 BizTalk 應用程式。 若要在 Oracle 資料庫中叫用以 REF CURSOR 做為參數的函式，並提供 REF CURSOR 做為 out 參數，這些工作如下：
建立 BizTalk 專案，併為您想要在 Oracle 資料庫中叫用的函式產生架構。
在 BizTalk 專案中建立訊息，以便從 Oracle 資料庫傳送和接收訊息。
建立協調流程以在 Oracle 資料庫中叫用函式。
建置及部署 BizTalk 專案。
藉由建立實體傳送和接收埠來設定 BizTalk 應用程式。
啟動 BizTalk 應用程式。
本主題提供執行這些工作的指示。
此主題的範例
根據本主題，一個名為 Func_RefCursor 的範例也隨附於 BizTalk Adapter Pack 中。 如需詳細資訊，請參閱 配接器範例。
產生架構
在本主題中，為了示範 Oracle 資料庫配接器如何支援叫用採用 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資料庫作業的元數據 。
定義訊息和訊息類型
您稍早產生的架構描述協調流程中訊息所需的「類型」。 訊息通常是變數，其類型是由對應的架構所定義。 您必須將您在第一個步驟中產生的架構連結至 BizTalk 專案的 [協調流程檢視] 視窗的訊息。
針對本主題，您必須建立兩個訊息：一個是將要求傳送至 Oracle 資料庫，另一個是接收回應。
執行下列步驟來建立訊息，並將其連結至架構：
建立訊息並連結至架構
如果 BizTalk 專案尚未開啟，請開啟 BizTalk 專案的 [協調流程檢視] 視窗。 若要這樣做，請按一下 [檢視]，指向「其他 Windows」，然後按一下 [協調流程檢視]。
在 [協調流程檢視] 中，以滑鼠右鍵按兩下 [ 訊息]，然後按兩下 [ 新增訊息]。
以滑鼠右鍵按下新建立的訊息，然後選取 [ 屬性視窗]。
在 屬性 窗格中，對 Message_1 執行下列動作：
使用此 若要這樣做 識別碼 輸入 要求。 訊息類型 從下拉式清單中，展開 [ 架構]，然後選取 [Func_RefCursor.OracleDBBindingSchema.GET_ACTIVITY]，其中 Func_RefCursor 是 BizTalk 項目的名稱。 OracleDBBindingSchema 是針對GET_ACTIVITY程式所產生的架構。 重複上一個步驟以建立新的訊息。 在新訊息的 [ 屬性 ] 窗格中，執行下列動作：
使用此 若要這樣做 識別碼 輸入 回應。 訊息類型 Func_RefCursor.OracleDBBindingSchema.GET_ACTIVITYResponse
設定協調流程
您必須建立 BizTalk 協調流程，才能使用 BizTalk Server 來叫用具有 REF CURSOR 參數的程式。 在此協調流程中，您會在定義的接收位置放置要求訊息。 Oracle Database 配接器會取用此訊息，並透過 ODP 將它傳遞給 Oracle 資料庫。 Oracle 資料庫的回應會儲存至另一個位置。 使用 REF CURSOR 叫用函式和程式的典型協調流程會包含：
傳送和接收圖形以將訊息傳送至 Oracle 資料庫並接收回應。
單向接收埠，用來接收傳送至 Oracle 資料庫的要求訊息。
雙向傳送埠，將要求訊息傳送至 Oracle 資料庫並接收回應。
單向傳送埠，以將回應從 Oracle 資料庫傳送至資料夾。
範例協調流程如下所示：
在 Oracle 中使用 Ref Cursors 的協同流程 41ed9647-a49d-4122-b9fc-c5ce4dca3533
新增訊息圖形
請確定您為每個訊息圖形指定下列屬性。 Shape 數據行中所列的名稱是訊息圖形的名稱，如剛才提及的協調流程所示。
| 形狀 | 圖形類型 | 性能 |
|---|---|---|
| 接收訊息 | 收到 | - 將 名稱 設定為 ReceiveMessage - 將 Activate 設定為 True |
| 發送訊息 | 發送 | - 將 [名稱] 設定為 SendMessage |
| 接收回應 | 收到 | - 將 [名稱] 設定為 ReceiveResponse - 將 Activate 設定為 False |
| SendResponse | 發送 | - 將 [名稱] 設定為 SendResponse |
新增埠
請確定您為每個邏輯埠指定下列屬性。 [埠] 資料行中所列的名稱是協調流程中顯示的埠名稱。
| 港口 | 性能 |
|---|---|
| 檔案輸入 | - 將 標識碼 設定為 FileIn - 將 Type 設定為 FileInType - 將 通訊模式 設定為 單向 - 將 通訊方向 設定為 接收 |
| LOBPort | - 將 識別碼 設定為 LOBPort - 將 [類型 ] 設定為 LOBPortType - 將 通訊模式 設定為 要求-回應 - 將 通訊方向 設定為 傳送接收 |
| 儲存回應 | - 將 標識碼 設定為 SaveResponse - 將 類型 設定為 SaveResponseType - 將 通訊模式 設定為 單向 - 將 通訊方向 設定為 傳送 |
設定動作圖形的訊息，並將其連接到端口
下表列出您應設定的屬性及其值，以指定動作圖形的訊息並將其連結到埠。 Shape 數據行中所列的名稱是訊息圖形的名稱，如先前所述的協調流程所示。
| 形狀 | 性能 |
|---|---|
| 接收訊息 | - 將 訊息 設定為 要求 - 將 作業 設定為 FileIn.REFCURSOR.Request |
| 發送訊息 | - 將 訊息 設定為 要求 - 將 作業 設定為 LOBPort.REFCURSOR.Request |
| 接收回應 | - 將 訊息 設定為 回應 - 將 作業 設定為 LOBPort.REFCURSOR.Response |
| SendResponse | - 將 訊息 設定為 回應 - 將 作業 設定為 SaveResponse.REFCURSOR.Request |
指定這些屬性之後，訊息圖形和埠會連線，且您的協調流程已完成。
您現在必須建置 BizTalk 解決方案，並將其部署至 BizTalk Server。 如需詳細資訊，請參閱 建置和執行協調流程。
設定 BizTalk 應用程式
部署 BizTalk 項目之後，您稍早建立的協調流程會列在 BizTalk Server 管理控制台的 [ 協調流程 ] 窗格底下。 您必須使用 BizTalk Server 管理主控台來設定應用程式。 如需逐步講解，請參閱 逐步解說：部署基本 BizTalk 應用程式。
設定應用程式牽涉到：
選取應用程式的主機。
將您在協調流程中建立的埠對應至 BizTalk Server 管理控制台中的實體埠。 為了這次編排，您必須：
確定硬碟上的一個位置以及相應的檔案埠址，在該處您將放置要求訊息。 BizTalk 協調流程會取用要求訊息，並將其傳送至 Oracle 資料庫。
定義硬碟上的位置，以及 BizTalk 協調流程將卸除包含 Oracle 資料庫回應的回應訊息的對應檔案埠。
定義實體 WCF-Custom 或 WCF-OracleDB 傳送埠以將訊息傳送至 Oracle 資料庫。 您也必須在傳送埠中指定動作。 如需如何建立 WCF-Custom 或 WCF-OracleDB 埠的相關信息，請參閱 手動設定實體埠系結至 Oracle Database Adapter。
備註
使用 BizTalk 專案增益集的 Consume Adapter Service 產生結構描述，也會建立繫結檔案，其中包含埠的相關資訊，以及將要為這些埠設定的操作。 您可以從 BizTalk Server 管理主控台匯入此系結檔案，以建立傳送埠（用於輸出通話）或接收埠（用於輸入通話）。 如需詳細資訊，請參閱 使用埠系結檔案設定實體埠系結至 Oracle Database。
啟動應用程式
您必須啟動 BizTalk 應用程式，才能叫用 Oracle 資料庫資料表中的程式。 如需啟動 BizTalk 應用程式的指示，請參閱 如何啟動協調流程。
在這個階段，請確定：
要接收編排要求訊息的 FILE 接收埠正在運行。
從協調流程接收回應訊息的 FILE 傳送埠正在執行中。
WCF-Custom 或 WCF-OracleDB 傳送埠以將訊息傳送至 Oracle 資料庫正在執行中。
作業的 BizTalk 協調流程正在執行中。
執行作業
執行應用程式之後，您必須將要求訊息放入 FILE 接收位置。 要求訊息的架構必須符合您稍早所產生程序的架構。 如需使用 Oracle 資料庫配接器叫用函式之要求訊息架構的詳細資訊，請參閱函式 和程式的 訊息架構。
若要叫用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 CURSOR。
可能的例外狀況
如需使用 BizTalk Server 叫用函式和程式時可能會遇到的例外狀況相關信息，請參閱 例外狀況和錯誤處理。
最佳做法
部署並設定 BizTalk 項目之後，您可以將組態設定匯出至稱為系結檔案的 XML 檔案。 產生系結檔案之後，您可以從檔案匯入組態設定，讓您不需要為相同的協調流程建立傳送埠、接收埠等。 如需系結檔案的詳細資訊，請參閱 重複使用 Oracle 資料庫配接器系結。