Gerenciando conexões e sessões (XMLA)

Statefulness é uma condição em que o servidor preserva a identidade e o contexto de um cliente entre chamadas de método. Statelessness é uma condição em que o servidor não se lembra da identidade e do contexto de um cliente após a conclusão de uma chamada de método.

Para fornecer statefulness, o XMLA (XML for Analysis) dá suporte a sessões que permitem que uma série de instruções seja executada em conjunto. Um exemplo de uma dessas séries de instruções seria a criação de um membro calculado a ser usado em consultas subseqüentes.

Em geral, as sessões em XMLA seguem o comportamento a seguir, descrito pela especificação do OLE DB 2.6:

• As sessões definem o escopo do contexto de comando e de transação.

• Vários comandos podem ser executados no contexto de uma única sessão.

• O suporte a transações no contexto XMLA é oferecido por comandos específicos do provedor enviados com o método Execute.

O XMLA define uma forma de suportar sessões em um ambiente da Web em um modo similar à abordagem usada pelo protocolo DAV (Distributed Authoring and Versioning) para a implementação do bloqueio em um ambiente flexível. Esta implementação se compara ao DAV, já que o provedor pode fazer uma sessão expirar por vários motivos (por exemplo, um tempo limite ou um erro de conexão). Quando as sessões forem suportadas, os serviços Web deverão estar atentos e prontos para lidarem com conjuntos de comandos interrompidos que deverão ser reiniciados.

A especificação do protocolo SOAP do W3C (World Wide Web Consortium) recomenda a utilização de cabeçalhos SOAP para a criação de novos protocolos sobre mensagens SOAP. A tabela a seguir lista os elementos e os atributos de cabeçalho SOAP definidos pelo XMLA para iniciar, manter e fechar uma sessão.

Cabeçalho SOAP	Descrição
BeginSession	Este cabeçalho solicita que o provedor crie uma sessão nova. O provedor deve responder criando uma sessão nova e retornando a ID de sessão como parte do cabeçalho Session na resposta SOAP.
SessionId	A área de valor contém a ID de sessão que deve ser usada em cada chamada de método para o resto da sessão. O provedor na resposta de SOAP envia esta marca e o cliente também deve enviar este atributo com cada elemento do cabeçalho Session.
Session	Para cada chamada de método ocorrida na sessão, este cabeçalho deverá ser usado e a ID de sessão deverá ser incluída na área de valor do cabeçalho.
EndSession	Para finalizar a sessão, use este cabeçalho. A ID de sessão deve ser incluída com a área de valor.

Observação

A ID de sessão não garante que uma sessão permanecerá válida. Se a sessão expirar (por exemplo, se o tempo limite for alcançado ou se a conexão for interrompida), o provedor poderá optar por encerrar e reverter as ações dessa sessão. Como resultado, todas as chamadas de método subseqüentes feitas do cliente em uma ID de sessão falharão com um erro que indicará uma sessão inválida. Um cliente deve lidar com esta condição e estar preparado para reenviar as chamadas de método de sessão desde o princípio.

Exemplo de código herdado

O exemplo a seguir mostra como as sessões são suportadas.

1. Para iniciar a sessão, acrescente um cabeçalho BeginSession em SOAP à chamada de método XMLA a partir do cliente. Inicialmente, a área de valor estará em branco, já que a ID de sessão ainda não é conhecida.

   <SOAP-ENV:Envelope
      xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
      SOAP-ENV:encodingStyle="https://schemas.xmlsoap.org/soap/encoding/">
      <SOAP-ENV:Header>
         <XA:BeginSession
            xmlns:XA="urn:schemas-microsoft-com:xml-analysis"
            xsi:type="xsd:int"
            mustUnderstand="1"/>
      </SOAP-ENV:Header>
      <SOAP-ENV:Body>
         ...<!-- Discover or Execute call goes here.-->
      </SOAP-ENV:Body>
   </SOAP-ENV:Envelope>
   

2. A mensagem de resposta SOAP do provedor inclui a ID de sessão na área de cabeçalho de retorno, com a marca de cabeçalho XMLA <SessionId>.

   <SOAP-ENV:Header>
      <XA:Session
         xmlns:XA="urn:schemas-microsoft-com:xml-analysis"
         SessionId="581"/>
   </SOAP-ENV:Header>
   

3. O cabeçalho Session deve ser adicionado a cada chamada de método da sessão, com a ID de sessão retornada do provedor.

   <SOAP-ENV:Header>
      <XA:Session
         xmlns:XA="urn:schemas-microsoft-com:xml-analysis"
         mustUnderstand="1"
         SessionId="581"/>
   </SOAP-ENV:Header>
   

4. Quando a sessão for concluída, a <EndSession> marca será usada, com o valor de ID de sessão relacionado.

   <SOAP-ENV:Header>
      <XA:EndSession
         xmlns:XA="urn:schemas-microsoft-com:xml-analysis"
         xsi:type="xsd:int"
         mustUnderstand="1"
         SessionId="581"/>
   </SOAP-ENV:Header>
   

Consulte também

Conceitos

Usando XML for Analysis no Analysis Services (XMLA)