使用 BizTalk Server 在SQL Server上執行複合作業

發行項
10/14/2023

SQL 配接器可讓配接器用戶端在SQL Server資料庫上執行複合作業。複合作業可以包括：

插入、更新和刪除作業。複合作業不支援選取作業。
執行為作業的預存程式。

單一複合作業可以依任何順序擁有任何數目的這些作業。例如，您可以有兩個 Insert 作業後面接著 Delete 作業，最後是預存程式執行。此外，您可以有不同的作業以不同的資料庫資料表或檢視為目標。如需配接器如何支援複合作業的詳細資訊，請參閱使用 SQL 配接器在SQL Server中執行複合作業。如需複合作業之 SOAP 訊息結構的相關資訊，請參閱複合作業的訊息架構。

注意

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

如何在SQL Server上執行複合作業

搭配使用 SQL 配接器搭配BizTalk Server在SQL Server上執行作業牽涉到建置組塊中所述的程式工作，以使用 SQL 配接器開發 BizTalk 應用程式。若要在SQL Server資料庫上執行複合作業，這些工作如下：

建立 BizTalk 專案，並針對您要叫用的所有作業產生架構。
手動建立架構檔案，其中包含您在上一個步驟中產生之所有架構的參考。
在 BizTalk 專案中建立訊息，以便從SQL Server資料庫傳送和接收訊息。這些訊息必須符合您在上一個步驟中建立的要求和回應架構。
建立協調流程，在SQL Server資料庫上叫用複合作業。
建置和部署 BizTalk 專案。
藉由建立實體傳送和接收埠來設定 BizTalk 應用程式。
啟動 BizTalk 應用程式。

本主題提供如何執行這些工作的指示。

以本主題為基礎的範例

根據本主題提供的範例 CompositeOperations 隨附 BizTalk 配接器套件。如需詳細資訊，請參閱 SQL 配接器的範例。

產生架構

在本主題中，為了示範如何執行複合作業，將會依指定的循序執行下列工作：

將記錄插入 EMPLOYEE 資料表。
叫用GET_LAST_EMP_DATA預存程式，以擷取最後一筆插入記錄的所有資料行。
從 EMPLOYEE 資料表中刪除記錄。

執行範例所提供的腳本，以建立 EMPLOYEE 資料表。如需範例的詳細資訊，請參閱架構範例。

您必須建立 BizTalk 專案，並使用取用配接器服務增益集來產生這些作業的架構。如需如何產生架構的詳細資訊，請參閱使用 SQL 配接器擷取 Visual Studio 中SQL Server作業的中繼資料。

建立複合架構定義

您現在必須建立複合架構，以參考針對個別作業建立的架構。執行下列步驟來建立複合架構定義。

新增複合架構定義

將架構檔案新增至 BizTalk 專案。以滑鼠右鍵按一下專案名稱，指向 [ 新增]，然後按一下 [ 新增專案]。在 [ 新增專案 ] 對話方塊中，從 [ 類別] 方塊中，按一下 [架構檔案]。從 [ 範本] 方塊中，按一下 [ 架構]。指定架構檔案的名稱，然後按一下 [ 確定]。

在此範例中，請將架構檔案名指定為 CompositeSchema.xsd 。
新增針對您要執行之不同作業所產生的架構參考。在此範例中，針對作業產生的不同架構如下：
- TableOperation.dbo.Employee.xsd，用於插入和刪除作業。
- GET_LAST_EMP_DATA預存程式的 Procedure.dbo.xsd。
  
  若要新增參考：
1. 以滑鼠右鍵按一下 CompositeSchema.xsd 中的根< 架構 >節點，然後按一下 [屬性]。
2. 在 [屬性] 方塊中，按一下 [匯入] 屬性的省略號按鈕 (...) 。
3. 在 [ 匯入] 對話方塊中，從 [ 匯入新架構] 清單中，選取 [XSD 匯入]，然後按一下 [ 新增]。
4. 在 [ BizTalk 類型選擇器 ] 對話方塊中，展開 [BizTalk 專案名稱] 節點，展開 [ 架構]，然後選取您要匯入的架構。在此範例中，選取 < [BizTalk_project_name > ]。TableOperation_dbo_Employee。按一下 [確定]。
  
  重複此步驟以匯 < 入BizTalk_project_name > 。也Procedure_dbo。
5. 在 [ 匯入] 對話方塊中，按一下 [ 確定]。
將兩個子節點新增至根架構節點。一個子節點會對應至執行複合作業的要求架構。另一個子節點對應至回應架構。對應至要求架構的節點可以具有任何名稱。對應至回應架構的節點必須呼叫 < request_schema_node > Response。在此範例中，我們會將要求架構節點呼叫為 Request。因此，回應架構節點稱為 RequestResponse。

注意

根據預設，根節點也會新增至新的架構檔案。您可以將根節點重新命名為 [要求]。若要重新命名節點，請以滑鼠右鍵按一下節點名稱，然後按一下 [ 重新命名]。

若要在< 架構 >節點下新增節點：
1. 以滑鼠右鍵按一下< [架構 >] 節點，指向 [插入架構節點]，然後按一下 [子記錄]。
2. 將新節點重新命名為 RequestResponse。
在 [ 要求 ] 節點底下新增子節點，以對應至您將作為複合作業一部分執行之每個作業的要求架構。在此範例中，您必須新增對應至下列專案的子節點：
- 在 EMPLOYEE 資料表上插入和刪除作業。
- GET_LAST_EMP_DATA預存程式。
重要

您必須以您想要執行作業的相同順序新增節點。例如，如果您想要插入記錄，然後執行預存程式，然後刪除記錄，您必須先新增插入作業的節點，後面接著預存程式的節點，最後是 Delete 作業的節點。

若要將子節點新增至要求節點：
1. 以滑鼠右鍵按一下 [要求] 節點，指向 [ 插入架構節點]，然後按一下 [ 子記錄]。
  
  的子節點
2. 將記錄重新命名為對應至您在複合作業中執行之作業的要求架構。例如，將節點重新命名為「Insert」。
3. 將 [插入 ] 節點對應至 EMPLOYEE 資料表上 Insert 作業的要求架構。若要這樣做，請以滑鼠右鍵按一下 [插入 ] 節點，然後按一下 [ 屬性]。在 [ 屬性 ] 方塊的 [ 資料類型 ] 清單中，選取 [ 插入 (參考) 。
4. 重複這些步驟，為GET_LAST_EMP_DATA預存程式和 Delete 作業的要求架構新增節點。指定節點名稱，並將其對應至對應架構，如下表所述。
  
  節點名稱對應至架構
  
  GET_LAST_EMP_DATA GET_LAST_EMP_DATA (參考)
  
  刪除刪除 (參考)
在 RequestResponse 節點下新增子節點，此節點對應至您將作為複合作業一部分執行之每個作業的回應架構。在此範例中，您必須新增對應至下列專案的子節點：
- 在 EMPLOYEE 資料表上插入和刪除作業。
- GET_LAST_EMP_DATA預存程式。
重要

您必須以與 [要求 ] 節點下子節點相同的順序新增子節點。

若要將子節點新增至 RequestResponse 節點：
1. 以滑鼠右鍵按一下 RequestResponse 節點，指向 [插入架構節點]，然後按一下 [子記錄]。
2. 重新命名記錄，以對應至您在複合作業中執行之作業的回應架構。例如，將節點重新命名為「InsertResponse」。
3. 將 InsertResponse 節點對應至 EMPLOYEE 資料表上 Insert 作業的回應架構。若要這樣做，請以滑鼠右鍵按一下InsertResponse節點，然後按一下 [屬性]。 在 [ 屬性 ] 方塊的 [ 資料類型] 清單中，選取 [ 插入][回應] (參考) 。
4. 重複這些步驟，為GET_LAST_EMP_DATA預存程式和 Delete 作業的回應架構新增節點。指定節點名稱，並將其對應至下表所述的對應架構。
  
  節點名稱對應至架構
  
  GET_LAST_EMP_DATAResponse GET_LAST_EMP_DATAResponse (參考)
  
  DeleteResponse DeleteResponse (參考)
儲存 CompositeSchema.xsd 檔案。

節點名稱	對應至架構
GET_LAST_EMP_DATA	GET_LAST_EMP_DATA (參考)
刪除	刪除 (參考)

節點名稱	對應至架構
GET_LAST_EMP_DATAResponse	GET_LAST_EMP_DATAResponse (參考)
DeleteResponse	DeleteResponse (參考)

定義訊息和訊息類型

您在最後一個步驟中建立的複合架構描述協調流程中訊息所需的「類型」。訊息通常是變數，其類型是由對應的架構所定義。您現在必須建立協調流程的訊息，並將其連結至您在上一個步驟中建立的架構。

建立訊息並連結至架構

將協調流程新增至 BizTalk 專案。從方案總管，以滑鼠右鍵按一下 BizTalk 專案名稱，指向 [新增]，然後按一下 [新增專案]。輸入 BizTalk 協調流程的名稱，然後按一下 [ 新增]。
如果 BizTalk 專案尚未開啟，請開啟 [協調流程檢視] 視窗。若要這樣做，請按一下 [ 檢視]，指向 [其他視窗]，然後按一下 [ 協調流程檢視]。
在 [協調流程檢視] 中，以滑鼠右鍵按一下 [ 訊息]，然後按一下 [ 新增訊息]。
以滑鼠右鍵按一下新建立的訊息，然後選取 [ 屬性視窗]。

在Message_1的 [屬性] 窗格中，執行下列動作：

使用	作法
識別碼	輸入 `Request`
訊息類型	從下拉式清單中，展開 [ 架構]，然後選取 [CompositeOp.CompositeSchema.Request]，其中 CompositeOp 是 BizTalk 專案的名稱。 CompositeSchema 是您針對複合作業手動建立的架構。

重複步驟 2 以建立新的訊息。在新訊息的 [ 屬性 ] 窗格中，執行下列動作：

使用作法

識別碼輸入 Response

訊息類型從下拉式清單中，展開 [ 架構]，然後選取 [CompositeOp.CompositeSchema.RequestResponse]。

使用	作法
識別碼	輸入 `Response`
訊息類型	從下拉式清單中，展開 [ 架構]，然後選取 [CompositeOp.CompositeSchema.RequestResponse]。

設定協調流程

您必須建立 BizTalk 協調流程，才能使用BizTalk Server在SQL Server上執行複合作業。在此協調流程中，您會在定義的接收位置卸載要求訊息。要求訊息必須符合您稍早建立的複合架構。 SQL 配接器會取用此訊息，並將它傳遞給SQL Server。來自SQL Server的回應會儲存至另一個位置。您必須包含傳送和接收圖形，才能分別將訊息傳送至SQL Server和接收回應。執行複合作業的基本協調流程如下所示：

Peform 複合作業的協調流程

新增訊息圖形

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

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

新增埠

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

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

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

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

圖形	屬性
ReceiveMessage	- 將訊息設定為要求 - 將作業設定為 MessageIn.CompositeOp.Request
SendMessage	- 將訊息設定為要求 - 將作業設定為 LOBPort.CompositeOp.Request
ReceiveResponse	- 將訊息設定為回應 - 將作業設定為 LOBPort.CompositeOp.Response
SendResponse	- 將訊息設定為回應 - 將作業設定為 ResponseOut.CompositeOp.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資料庫。因為做為複合作業一部分的作業是在單一交易中執行，所以請確定 UseAmbientTransaction 系結屬性已設定為 True。
  
  您也必須在傳送埠中指定動作。複合作業的動作是「CompositeOperation」。如需如何建立埠的資訊，請參閱手動設定 SQL 配接器的實體埠系結。如需如何指定埠動作的詳細資訊，請參閱設定 SQL 配接器的 SOAP 動作。
  
  注意
  
  使用取用配接器服務 BizTalk 專案增益集產生架構也會建立系結檔案，其中包含要針對這些埠設定的埠和動作的相關資訊。您可以從 BizTalk Server 管理主控台匯入此系結檔案，以建立輸出通話的傳送埠 () ，或針對輸入呼叫) 接收埠 (。如需詳細資訊，請參閱使用埠系結檔案設定實體埠系結以使用 SQL 配接器。如果您匯入此系結檔案，在產生架構時，WCF-Custom 或 WCF-SQL 傳送埠上的動作會設定為動態動作，涉及您在取用配接器服務增益集中選取的所有作業。針對複合作業，您必須將動態動作取代為「CompositeOperation」。

啟動應用程式

您必須啟動 BizTalk 應用程式，才能在SQL Server資料庫上執行複合作業。如需啟動 BizTalk 應用程式的指示，請參閱如何啟動協調流程。

在這個階段，請確定：

要接收協調流程要求訊息的 FILE 接收埠正在執行。
從協調流程接收回應訊息的 FILE 傳送埠正在執行。
WCF-Custom 或 WCF-SQL 傳送埠，以將訊息傳送至SQL Server資料庫正在執行。
作業的 BizTalk 協調流程正在執行。

執行作業

執行應用程式之後，您必須將要求訊息卸載至 FILE 接收位置。要求訊息的架構必須符合您稍早建立之複合作業的架構。例如，在 EMPLOYEE 資料表中插入記錄的要求訊息、叫用GET_LAST_EMP_DATA預存程式，並從 EMPLOYEE 資料表中刪除記錄為：

<Request xmlns="http://CompositeTest.CompositeSchema">  
  <Insert xmlns="http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/Employee">  
    <Rows>  
      <Employee xmlns="http://schemas.microsoft.com/Sql/2008/05/Types/Tables/dbo">  
        <Name>John</Name>  
        <Designation>Manager</Designation>  
        <Salary>100000</Salary>  
      </Employee>  
    </Rows>  
  </Insert>  
  <GET_LAST_EMP_DATA xmlns="http://schemas.microsoft.com/Sql/2008/05/Procedures/dbo" />  
  <Delete xmlns="http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/Employee">  
    <Rows>  
      <Employee xmlns="http://schemas.microsoft.com/Sql/2008/05/Types/Tables/dbo">  
        <Name>John</Name>  
      </Employee>  
    </Rows>  
  </Delete>  
</Request>

如需使用 SQL 配接器在SQL Server資料庫上執行複合作業之要求訊息架構的詳細資訊，請參閱複合作業的訊息架構。

協調流程會取用訊息，並將它傳送至SQL Server資料庫。 SQL Server資料庫的回應會儲存在定義為協調流程一部分的其他 FILE 位置。例如，上述要求訊息SQL Server資料庫的回應為：

<?xml version="1.0" encoding="utf-8" ?>   
<RequestResponse xmlns="http://CompositeTest.CompositeSchema">  
  <InsertResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/Employee">  
    <InsertResult>  
      <long xmlns="http://schemas.microsoft.com/2003/10/Serialization/Arrays">10080</long>   
    </InsertResult>  
  </InsertResponse>  
  <GET_LAST_EMP_DATAResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/Procedures/dbo">  
    <GET_LAST_EMP_DATAResult>  
      <DataSet xmlns="http://schemas.datacontract.org/2004/07/System.Data">  
        <xs:schema id="NewDataSet" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">  
          <xs:element msdata:IsDataSet="true" name="NewDataSet">  
            <xs:complexType>  
              <xs:sequence>  
                <xs:element minOccurs="0" maxOccurs="unbounded" name="NewTable">  
                  <xs:complexType>  
                    <xs:sequence>  
                      <xs:element minOccurs="0" name="Employee_ID" type="xs:int" />   
                      <xs:element minOccurs="0" name="Name" type="xs:string" />   
                      <xs:element minOccurs="0" name="DOJ" type="xs:dateTime" />   
                      <xs:element minOccurs="0" name="Designation" type="xs:string" />   
                      <xs:element minOccurs="0" name="Job_Description" type="xs:string" />   
                      <xs:element minOccurs="0" name="Photo" type="xs:base64Binary" />   
                      <xs:element minOccurs="0" name="Rating" type="xs:string" />   
                      <xs:element minOccurs="0" name="Salary" type="xs:decimal" />   
                      <xs:element minOccurs="0" name="Last_Modified" type="xs:base64Binary" />   
                    </xs:sequence>  
                  </xs:complexType>  
                </xs:element>  
              </xs:sequence>  
            </xs:complexType>  
          </xs:element>  
        </xs:schema>  
        <diffgr:diffgram xmlns:diffgr="urn:schemas-microsoft-com:xml-diffgram-v1">  
          <NewDataSet xmlns="">  
            <NewTable>  
              <Employee_ID>10080</Employee_ID>   
              <Name>John</Name>   
              <Designation>Manager</Designation>   
              <Salary>100000.00</Salary>   
              <Last_Modified>AAAAAAAAF40=</Last_Modified>   
            </NewTable>  
          </NewDataSet>  
        </diffgr:diffgram>  
      </DataSet>  
    </GET_LAST_EMP_DATAResult>  
    <ReturnValue>0</ReturnValue>   
  </GET_LAST_EMP_DATAResponse>  
  <DeleteResponse xmlns="http://schemas.microsoft.com/Sql/2008/05/TableOp/dbo/Employee">  
    <DeleteResult>1</DeleteResult>   
  </DeleteResponse>  
</RequestResponse>

上述回應包含多個結果集，對應做為複合作業一部分執行的不同作業。例如，元素 InsertResult 包含 10080，這是新加入記錄的唯一識別碼。

最佳做法

部署並設定 BizTalk 專案之後，您可以將組態設定匯出至稱為系結檔案的 XML 檔案。產生系結檔案之後，您可以從檔案匯入組態設定，因此您不需要為相同的協調流程建立傳送埠和接收埠等專案。如需系結檔案的詳細資訊，請參閱重複使用配接器系結。

另請參閱

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

共用方式為