Share via

  • Artículo

Elemento Session (XMLA)

Utiliza el encabezado SOAP en un mensaje de solicitud SOAP para identificar una sesión explícita existente 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>
      ...
      <Session
         xmlns="urn:schemas-microsoft-com:xml-analysis"
         SessionId="string" />
      ...
   </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 aparecer una y sólo una vez.

Relaciones del elemento

Relación

Elemento

Elementos primarios

Ninguno

Elementos secundarios

Ninguno

Atributos

Atributo

Descripción

SessionId

Atributo String requerido que identifica la sesión que se va a utilizar. Analysis Services utiliza un identificador único global (GUID) para identificar una sesión.

Comentarios

El elemento de encabezado Session identifica una sesión existente explícitamente iniciada en la instancia de Analysis Services. El elemento Session forma parte del encabezado SOAP en los siguientes tipos de mensajes:

  • Una respuesta SOAP que contiene un elemento de encabezado SOAP BeginSession.

  • Una solicitud SOAP para identificar la sesión en la que ejecutar el método Discover o el método Execute.

Un identificador de sesión no garantiza que una sesión continúe siendo válida. La sesión especificada en el elemento Session puede caducar. Por ejemplo, una sesión puede caducar si supera el tiempo de espera o se interrumpe la conexión asociada a la sesión. Si la sesión caduca o deja de ser válida, Analysis Services finaliza la sesión y revierte cualquier transacción que esté en curso en ese momento. Cualquier mensaje SOAP enviado con un identificador de sesión que ya no sea válido emitirá un error SOAP que indica que la sesión especificada no se puede encontrar.

Si un elemento Session no se envía como parte de una solicitud SOAP, la instancia Analysis Services iniciará implícitamente una sesión mientras que dure la llamada a los métodos Discover o Execute y, a continuación, finalizará dicha sesión una vez finalizada la llamada al método.