Elemento Session (XMLA)
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 MicrosoftSQL ServerAnalysis 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 |
|---|---|
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 |
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