管理連接與工作階段 (XMLA)

Statefulness 是伺服器在方法呼叫之間保留用戶端之識別與內容的情況。Statelessness 是伺服器在方法呼叫完成之後，不記得用戶端之識別與內容的情況。

若要提供 Statefulness，XML for Analysis (XMLA) 支援允許一系列的陳述式一起執行的「工作階段」。這樣一系列的陳述式範例，將會建立用於後續查詢的導出成員。

一般而言，在 XMLA 中的工作階段會遵循 OLE DB 2.6 規格所述的下列行為：

• 工作階段定義交易和命令內容範圍。

• 在單一工作階段的內容中可以執行多個命令。

• 對於 XMLA 內容中交易的支援是透過與 Execute 方法一起傳送的提供者特定命令來達成的。

XMLA 定義了一個方法，可支援在 Web 環境中的工作階段，其所使用的模式類似於分散式撰寫及版本處理 (DAV) 通訊協定所使用的方法，可在鬆散偶合的環境中實作鎖定。這個實作與 DAV 相似，因為其允許提供者基於各種理由 (例如，逾時或是連接錯誤) 使工作階段過期。當再度支援工作階段時，Web 服務必須知道並準備處理必須重新啟動之中斷的命令集。

World Wide Web Consortium (W3C) 簡易物件存取通訊協定 (SOAP) 規格建議使用 SOAP 標頭，在 SOAP 訊息上面建立新的通訊協定。下表列出 XMLA 為起始、維護和關閉工作階段，所定義的 SOAP 標頭元素與屬性。

SOAP 標頭	說明
BeginSession	此標頭要求提供者建立新的工作階段。提供者應該建構新的工作階段，並在 SOAP 回應中，將工作階段識別碼與 Session 標頭一起傳回。
SessionId	值區域包含的工作階段識別碼，必須用於工作階段其餘部分的每個方法呼叫。在 SOAP 回應中的提供者會傳送這個標記，而用戶端也必須將這個屬性與每個 Session 標頭元素一起傳送。
Session	對於每個發生在工作階段的方法呼叫，都必須使用這個標頭，而且在標頭的值區域中必須包括工作階段識別碼。
EndSession	若要結束工作階段，請使用這個標頭。值區域必須包括工作階段識別碼。

[!附註]

工作階段識別碼並不保證工作階段會維持有效狀態。如果工作階段過期 (例如，如果逾時或是連接中斷)，提供者可以選擇結束和回復該工作階段的動作。因此，所有後續從用戶端對工作階段識別碼發出的方法呼叫都會失敗，並產生指出工作階段無效的錯誤。用戶端應該要處理這個狀況，並準備從頭開始，重新傳送工作階段方法呼叫。

舊版程式碼範例

以下範例將示範如何支援工作階段。

1. 若要開始工作階段，請將 SOAP 中的 BeginSession 標頭從用戶端加入輸出 XMLA 方法。值區域一開始是空白的，因為還不知道工作階段識別碼。

   <SOAP-ENV:Envelope
      xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
      SOAP-ENV:encodingStyle="https://schemas.xmlsoap.org/soap/encoding/">
      <SOAP-ENV:Header>
         <XA:BeginSession
            xmlns:XA="urn:schemas-microsoft-com:xml-analysis"
            xsi:type="xsd:int"
            mustUnderstand="1"/>
      </SOAP-ENV:Header>
      <SOAP-ENV:Body>
         ...<!-- Discover or Execute call goes here.-->
      </SOAP-ENV:Body>
   </SOAP-ENV:Envelope>
   

2. 提供者的 SOAP 回應訊息包括傳回標頭區域中的工作階段識別碼，它使用 XMLA 標頭標記 <SessionId>。

   <SOAP-ENV:Header>
      <XA:Session
         xmlns:XA="urn:schemas-microsoft-com:xml-analysis"
         SessionId="581"/>
   </SOAP-ENV:Header>
   

3. 工作階段中的每個方法呼叫都必須加入 Session 標頭，以包含從提供者傳回的工作階段識別碼。

   <SOAP-ENV:Header>
      <XA:Session
         xmlns:XA="urn:schemas-microsoft-com:xml-analysis"
         mustUnderstand="1"
         SessionId="581"/>
   </SOAP-ENV:Header>
   

4. 當工作階段完成時，則會使用包含相關的工作階段識別碼值 <EndSession> 標記。

   <SOAP-ENV:Header>
      <XA:EndSession
         xmlns:XA="urn:schemas-microsoft-com:xml-analysis"
         xsi:type="xsd:int"
         mustUnderstand="1"
         SessionId="581"/>
   </SOAP-ENV:Header>
   

請參閱

概念

在 Analysis Services (XMLA) 中使用 XML for Analysis