共用方式為

  • 發行項

Session 元素 (XMLA)

在 SOAP 要求訊息中使用 SOAP 標頭，以便在 MicrosoftSQL ServerAnalysis Services 執行個體上識別現有的明確工作階段。

**命名空間：**urn:schemas-microsoft-com:xml-analysis

語法

<soap:Envelope xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      ...
      <Session
         xmlns="urn:schemas-microsoft-com:xml-analysis"
         SessionId="string" />
      ...
   </soap:Header>
   <soap:Body>
      ...
   </soap:Body>
</soap:Envelope>

元素特性

特性

描述

資料類型和長度

無

預設值

無

基數

0-1: 只能出現一次的選擇性元素。

元素關聯性

關聯性

元素

父元素

無

子元素

無

屬性

屬性

描述

SessionId

必要的 String 屬性，可識別要使用的工作階段。Analysis Services 會使用全域唯一識別碼 (GUID) 來識別工作階段。

備註

Session 標頭元素會在 Analysis Services 執行個體上識別現有且明確啟動的工作階段。Session 元素屬於下列訊息類型中 SOAP 標頭的一部分：

  • 包含 BeginSession SOAP 標頭元素的 SOAP 回應。

  • SOAP 要求，可識別要在上面執行 Discover 或 Execute 方法的工作階段。

工作階段識別碼並不保證工作階段會維持有效狀態。在 Session 元素中指定的工作階段可能會過期。例如，如果工作階段逾時或是與工作階段有關的連接中斷，則此工作階段可能會過期。如果此工作階段過期而不再有效，則 Analysis Services 會結束此工作階段，並回復目前進行中的任何交易。與不再有效的工作階段識別碼一起傳送的任何 SOAP 訊息都會失敗，而且會出現一個 SOAP 錯誤，表示找不到指定的工作階段。

如果 Session 元素沒有當做 SOAP 要求的一部分傳送，Analysis Services 執行個體就會在 Discover 或 Execute 方法呼叫的持續時間內隱含地啟動工作階段，然後在方法呼叫完成時結束該工作階段。