共用方式為


使用與 SQL 配接器搭配BizTalk Server插入、更新、刪除或選取作業

Microsoft BizTalk Adapter for SQL Server會在SQL Server資料庫資料表和檢視表上呈現一組標準作業。 這些稱為資料操作語言 (DML) 作業。 藉由使用 DML 作業,您可以在資料表和檢視上執行簡單的插入、更新、選取和刪除作業。 如需配接器如何支援這些作業的詳細資訊,請參閱使用 SQL 配接器 在資料表和檢視上插入、更新、刪除和選取作業。 如需這些作業之 SOAP 訊息結構的相關資訊,請參閱 資料表和檢視表上的插入、更新、刪除和選取作業的訊息架構

注意

如果您要對具有使用者定義型別資料行的資料表執行作業,請務必在開始開發應用程式之前,先參閱具有 User-Defined 類型之資料表和檢視上的作業

如何在SQL Server資料庫上執行基本作業

搭配使用 SQL 配接器搭配 BizTalk Server,在SQL Server資料庫上執行作業牽涉到建置組塊中所述的程式工作,以使用 SQL 配接器開發 BizTalk 應用程式。 若要在SQL Server中執行資料表和檢視的插入、更新、刪除或選取作業,這些工作如下:

  1. 建立 BizTalk 專案,並針對您想要在SQL Server資料庫資料表或檢視上叫用的作業產生架構。

  2. 在 BizTalk 專案中建立訊息,以便從SQL Server資料庫傳送和接收訊息。

  3. 建立協調流程,以在SQL Server資料庫資料表或檢視表上叫用作業。

  4. 建置和部署 BizTalk 專案。

  5. 藉由建立實體傳送和接收埠來設定 BizTalk 應用程式。

  6. 啟動 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 類型

定義訊息和訊息類型

您稍早產生的架構描述協調流程中訊息所需的「類型」。 訊息通常是變數,這是對應架構所定義的型別。 您現在必須建立協調流程的訊息,並將其連結至您在上一個步驟中產生的架構。

  1. 將協調流程新增至 BizTalk 專案。 從 方案總管,以滑鼠右鍵按一下 BizTalk 專案名稱,指向 [新增],然後按一下 [新增專案]。 輸入 BizTalk 協調流程的名稱,然後按一下 [ 新增]。

  2. 如果 BizTalk 專案尚未開啟,請開啟 [協調流程檢視] 視窗。 若要這樣做,請按一下 [ 檢視],指向 [其他 Windows],然後按一下 [ 協調流程檢視]。

  3. 在 [協調流程檢視] 中,以滑鼠右鍵按一下 [ 訊息],然後按一下 [ 新增訊息]。

  4. 以滑鼠右鍵按一下新建立的訊息,然後選取 [ 屬性視窗]。

  5. Message_1的 [屬性]窗格中,執行下列動作:

    使用 作法
    識別碼 輸入 Request
    訊息類型 從下拉式清單中展開 [ 架構],然後選取 [SelectTable.TableOperation_dbo_Employee.Select],其中 SelectTable 是您 BizTalk 專案的名稱。 TableOperation_dbo_Employee是針對 EMPLOYEE 資料表上 Select 作業產生的架構。
  6. 重複步驟 2 以建立新的訊息。 在新訊息的 [ 屬性] 窗格中,執行下列動作:

    使用 作法
    識別碼 輸入 Response
    訊息類型 從下拉式清單中展開 [ 架構],然後選取 [SelectTable.TableOperation_dbo_Employee.SelectResponse]。

設定協調流程

您必須建立 BizTalk 協調流程,才能使用BizTalk Server在 SQL Server 上執行作業。 在此協調流程中,您會在定義的接收位置卸載要求訊息。 SQL 配接器會取用此訊息,並將其傳遞至SQL Server。 來自SQL Server的回應會儲存到另一個位置。 您必須包含傳送和接收圖形,才能將訊息分別傳送至SQL Server和接收回應。 Select 作業的範例協調流程如下所示:

e74e342f-ba66-41fe-bd34-d45cd8767ef8SQL Server

新增訊息圖形

請確定您為每個訊息圖形指定下列屬性。 Shape 資料行中列出的名稱是訊息圖形的名稱,如剛才提及的協調流程所示。

圖形 圖形類型 屬性
ReceiveMessage 接收 - 將 [名稱 ] 設定為 ReceiveMessage
- 將 Activate 設定為 True
SendMessage 傳送 - 將 [名稱 ] 設定為 SendMessage
ReceiveResponse 接收 - 將 名稱 設定為 ReceiveResponse
- 將 Activate 設定為 False
SendResponse 傳送 - 將 名稱 設定為 SendResponse

新增埠

請確定您為每個邏輯埠指定下列屬性。 [埠] 資料行中列出的名稱是協調流程中顯示的埠名稱。

連接埠 屬性
MessageIn - 將 識別碼 設定為 MessageIn
- 將 類型 設定為 MessageInType
- 將 通訊模式 設定為 單向
- 將 通訊方向 設定為 接收
LOBPort - 將 識別碼 設定為 LOBPort
- 將 Type 設定為 LOBPortType
- 將 通訊模式 設定為 Request-Response
- 將 通訊方向 設定為 Send-Receive
ResponseOut - 將 識別碼 設定為 ResponseOut
- 將 [類型] 設定為 ResponseOutType
- 將 通訊模式 設定為 單向
- 設定要傳送的通訊方向

指定動作圖形的訊息,並將其連接到埠

下表指定屬性及其值,您應該設定為指定動作圖形的訊息,以及將訊息連結至埠。 Shape 資料行中所列的名稱是如先前所述協調流程中顯示的訊息圖形名稱。

圖形 屬性
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資料庫的回應訊息。

    • 定義實體 WCF-Custom 或 WCF-SQL 傳送埠,以將訊息傳送至SQL Server資料庫。 您也必須在傳送埠中指定動作。 如需如何建立埠的資訊,請參閱 手動設定 SQL 配接器的實體埠系結

      注意

      使用取用配接器服務 BizTalk 專案增益集產生架構也會建立系結檔案,其中包含要針對這些埠設定的埠和動作的相關資訊。 您可以從 BizTalk Server 管理主控台匯入此系結檔案,以建立輸出通話的傳送埠 () ,或針對輸入呼叫) 接收埠 (。 如需詳細資訊,請參閱 使用埠系結檔案設定實體埠系結以使用 SQL 配接器

啟動應用程式

您必須啟動 BizTalk 應用程式,才能從SQL Server資料庫資料表中選取記錄。 如需啟動 BizTalk 應用程式的步驟,請參閱 如何啟動協調流程

在這個階段,請確定:

  • 要接收協調流程要求訊息的 FILE 接收埠正在執行。

  • 從協調流程接收回應訊息的 FILE 傳送埠正在執行。

  • WCF-Custom 或 WCF-SQL 傳送埠,以將訊息傳送至SQL Server資料庫正在執行。

  • 作業的 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 配接器在 SQL Server資料庫資料表和檢視表上執行基本 DML 作業之要求訊息架構的詳細資訊,請參閱插入、更新、刪除和選取作業的訊息架構。

協調流程會取用訊息,並將其傳送至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插入、更新或刪除大量資料」問題。

另請參閱

使用 SQL 配接器開發 BizTalk 應用程式