Compartilhar 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 de Microsoft SQL Server Analysis Services.

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

Sintaxe

<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 do elemento

Característica

Descrição

Tipo de dados e comprimento

Nenhum

Valor padrão

Nenhum

Cardinalidade

0-1: elemento opcional que pode ocorrer apenas uma única vez.

Relações do elemento

Relação

Elemento

Elementos pai

Nenhum

Elementos filho

Nenhum

Comentários

O elemento do cabeçalho BeginSession faz parte de uma solicitação SOAP enviada a uma instância de Analysis Services e inicia explicitamente uma nova sessão na instância. O cabeçalho de SOAP retornado pela resposta de SOAP contém um elemento Session que identifica a nova sessão. Este identificador de nova sessão é armazenado e enviado em solicitações SOAP subseqüentes que usam o elemento de cabeçalho Session.

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 comandos XMLA (XML for Analysis) a seguir: BeginTransaction, CommitTransaction e RollbackTransaction. Todos os métodos e comandos XMLA executados em uma sessão iniciada implicitamente são considerados transações atômicas.