Share via

  • Artículo

Elemento BeginSession (XMLA)

Utiliza un encabezado SOAP en un mensaje de solicitud SOAP para iniciar una nueva sesión en una instancia de Microsoft SQL Server Analysis Services.

Espacio de nombres urn:schemas-microsoft-com:xml-analysis

Sintaxis

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

Características del elemento

Característica

Descripción

Tipo y longitud de datos

Ninguno

Valor predeterminado

Ninguno

Cardinalidad

0-1: Elemento opcional que puede tener lugar una y sólo una vez.

Relaciones del elemento

Relación

Elemento

Elementos primarios

Ninguno

Elementos secundarios

Ninguno

Comentarios

El elemento de encabezado BeginSession forma parte de una solicitud SOAP enviada a una instancia de Analysis Services e inicia explícitamente una nueva sesión en la instancia. El encabezado SOAP devuelto por la respuesta de SOAP contiene un elemento Session que identifica la nueva sesión. Este nuevo identificador de sesión se puede almacenar y enviar en solicitudes SOAP posteriores utilizando el elemento de encabezado Session.

Si no se envía el elemento de encabezado BeginSession, no se inicia explícitamente una sesión. Si no se inicia una sesión explícitamente, no se pueden administrar transacciones en esa sesión. En otras palabras, no puede utilizar los siguientes comandos de XML for Analysis (XMLA): BeginTransaction, CommitTransaction y RollbackTransaction. Todos los métodos XMLA y comandos ejecutados en una sesión iniciada implícitamente se consideran transacciones atómicas.