通过

  • 项目

Session 元素 (XMLA)

使用 SOAP 请求消息中的 SOAP 标头标识 Microsoft SQL Server Analysis 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 请求的一部分发送，则在 Discover 或 Execute 方法调用期间，Analysis Services 实例将隐式开始一个会话，然后在方法调用完成后结束该会话。