• Articolo

Gestione di connessioni e sessioni (XMLA)

La presenza di informazioni sullo stato rappresenta una condizione durante la quale il server mantiene l'identità e il contesto di un client tra le chiamate al metodo. L'assenza di informazioni sullo stato è una condizione durante la quale il server non ricorda l'identità e il contesto di un client dopo che una chiamata al metodo termina.

Per fornire informazioni sullo stato, in XML for Analysis (XMLA) sono supportate le sessioni che consentono l'esecuzione contemporanea di una serie di istruzioni. Un esempio di tale serie di istruzioni potrebbe essere la creazione di un membro calcolato da utilizzare in query successive.

In genere le sessioni in XMLA si comportano nel modo indicato dalla specifica OLE DB 2.6 e descritto di seguito:

  • Le sessioni definiscono l'ambito del contesto dei comandi e delle transazioni.

  • È possibile eseguire più comandi nel contesto di una singola sessione.

  • Il supporto per le transazioni nel contesto di XMLA viene fornito tramite comandi specifici del provider inviati con il metodo Execute.

XMLA definisce una modalità per supportare sessioni in un ambiente Web in modo analogo all'approccio utilizzato dal protocollo DAV (Distributed Authoring and Versioning) per implementare il blocco in un ambiente a regime di controllo libero. L'analogia con il protocollo DAV consiste nel fatto che è consentita la scadenza delle sessioni nel provider per diversi motivi, ad esempio se si verifica un timeout o un errore di connessione. Quando le sessioni sono supportate, i servizi Web devono essere consapevoli e pronti per gestire di set interrotti di comandi che devono essere riavviati.

La specifica SOAP (Simple Object Access Protocol ) definita dal World Wide Web Consortium (W3C) consiglia l'utilizzo di intestazioni SOAP per la creazione di nuovi protocolli nella parte superiore dei messaggi SOAP. Nella tabella seguente vengono elencati gli elementi dell'intestazione SOAP e gli attributi che XMLA definisce per avviare, gestire e chiudere una sessione.

Intestazione SOAP

Descrizione

BeginSession

Questa intestazione richiede al provider di creare una nuova sessione. Il provider deve rispondere costruendo una nuova sessione e restituendo l'ID di sessione come parte dell'intestazione Session nella risposta SOAP.

SessionId

Area del valore che contiene l'ID di sessione da utilizzare in ogni chiamata al metodo per il resto della sessione. Nella risposta SOAP il provider invia questo tag, che deve essere inviato inoltre anche dal client con ogni elemento dell'intestazione Session.

Session

Per ogni chiamata al metodo che si verifica nella sessione, questa intestazione deve essere utilizzata e l'ID di sessione deve essere incluso nell'area del valore dell'intestazione.

EndSession

Per terminare la sessione, utilizzare questa intestazione. L'ID di sessione deve essere incluso con l'area del valore.

Nota

Un ID di sessione non garantisce che una sessione rimanga valida. Se la sessione scade (ad esempio se si verifica un timeout o se la connessione si interrompe), il provider può scegliere di terminare le azioni di tale sessione e di eseguirne il rollback. Di conseguenza, tutte le chiamate al metodo successive eseguite dal client su un ID di sessione avranno esito negativo e restituiranno un errore che indica che la sessione non è valida. Un client deve gestire questa condizione e deve essere preparato per inviare nuovamente le chiamate al metodo della sessione a partire dall'inizio.

Codice di esempio legacy

Nell'esempio seguente viene illustrato come sono supportate le sessioni.

  1. Per avviare la sessione, aggiungere un'intestazione BeginSession in SOAP alla chiamata al metodo XMLA in uscita dal client. L'area del valore è inizialmente vuota perché l'ID di sessione non è ancora conosciuto.

    <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. Il messaggio di risposta SOAP dal provider include l'ID di sessione nell'area di intestazione restituita tramite l'utilizzo del tag di intestazione XMLA <SessionID>.

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

  3. Per ogni chiamata al metodo nella sessione, l'intestazione Session deve essere aggiunta e deve contenere l'ID di sessione restituito dal provider.

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

  4. Quando la sessione è completata, viene utilizzato il tag <EndSession> che contiene il valore dell'ID di sessione relativo.

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