Elemento Session (XMLA)

Usa o cabeçalho SOAP em uma mensagem de solicitação SOAP para identificar uma sessão explícita existente em uma instância do Analysis Services.

Namespace urn:schemas-microsoft-com:xml-analysis

Syntax

  
<soap:Envelope xmlns:soap="http://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 do elemento

Característica Descrição
Comprimento e tipo de dados Nenhum
Valor padrão Nenhum
Cardinalidade 0-1: elemento opcional que pode ocorrer apenas uma única vez.

Relações de elementos

Relação Elemento
Elementos pai Nenhum
Elementos filho Nenhum

Atributos

Atributo Descrição
SessionId Atributo obrigatório String que identifica a sessão a ser usada. A instância de servidor usa um GUID (identificador global exclusivo) para identificar uma sessão.

Comentários

O elemento de cabeçalho de sessão identifica uma sessão existente, explicitamente iniciada na instância. O elemento Session faz parte do cabeçalho SOAP nos seguintes tipos de mensagens:

  • Uma resposta SOAP que contém um elemento de cabeçalho SOAP BeginSession .

  • Uma solicitação SOAP para identificar a sessão na qual executar o método Discover ou Execute .

Um identificador de sessão não garante que uma sessão permaneça válida. A sessão especificada no elemento Session pode expirar. Por exemplo, uma sessão pode expirar se o tempo da sessão atingir seu limite ou se a conexão associada à sessão for interrompida. Se a sessão expirar e não for mais válida, o servidor encerrará a sessão e reverterá todas as transações atualmente em andamento. Qualquer mensagem SOAP que for enviada com um identificador de sessão inválido falhará, indicando que a sessão especificada não pode ser encontrada.

Se um elemento de sessão não for enviado como parte de uma solicitação SOAP, a instância iniciará implicitamente uma sessão durante a chamada de método Discover ou Execute e terminará essa sessão assim que a chamada do método for concluída.