Compartilhar via

Elemento Session (XMLA)

  • Artigo

Usa o cabeçalho SOAP em uma mensagem de solicitação SOAP para identificar uma sessão existente explícita 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>
      ...
      <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 do elemento

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. O Analysis Services usa um identificador global exclusivo (GUID) para identificar uma sessão.

Comentários

O elemento do cabeçalho Session identifica uma sessão existente explicitamente iniciada na instância Analysis Services. 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 Analysis Services finalizará a sessão e reverterá as transações que estiverem em andamento naquele momento. 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 Session não for enviado como parte de uma solicitação SOAP, a instância Analysis Services dará início a uma sessão, de maneira implícita, durante a chamada do método Discover ou Execute e finalizará essa sessão assim que a chamada do método for concluída.

Consulte também

Referência

Elemento EndSession (XMLA)

Conceitos

Gerenciando conexões e sessões (XMLA)

Outros recursos

Cabeçalhos (XMLA)