Share via


Elemento BeginSession (XMLA)

Usa um cabeçalho SOAP em uma mensagem de solicitação SOAP para iniciar uma nova sessão 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>  
      ...  
      <BeginSession  
         xmlns="urn:schemas-microsoft-com:xml-analysis" />  
      ...  
   </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

Comentários

O elemento de cabeçalho BeginSession faz parte de uma solicitação SOAP enviada a uma instância de servidor e inicia explicitamente uma nova sessão na instância. O cabeçalho SOAP retornado pela resposta SOAP contém um elemento Session que identifica a nova sessão. Esse novo identificador de sessão será armazenado e enviado em solicitações de SOAP subsequentes usando o elemento de cabeçalho de sessão .

Se o elemento de cabeçalho BeginSession não for enviado, uma sessão não será iniciada explicitamente. Se uma sessão não for iniciada explicitamente, as transações não poderão ser gerenciadas naquela sessão. Em outras palavras, você não pode usar os seguintes comandos de XML for Analysis (XMLA): BeginTransaction, CommitTransactione RollbackTransaction. Todos os métodos e comandos XMLA executados em uma sessão iniciada implicitamente são considerados transações atômicas.