• Articolo

Elemento Session (XMLA)

Utilizza l'intestazione SOAP in un messaggio di richiesta SOAP per identificare una sessione esplicita esistente in un'istanza di MicrosoftSQL ServerAnalysis Services.

Spazio dei nomi urn:schemas-microsoft-com:xml-analysis

Sintassi

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

Caratteristiche elemento

Caratteristica

Descrizione

Tipo di dati e lunghezza

Nessuno

Valore predefinito

Nessuno

Cardinalità

0-1: elemento facoltativo che può ricorrere una sola volta.

Relazioni elemento

Relazione

Elemento

Elementi padre

Nessuno

Elementi figlio

Nessuno

Attributi

Attributo

Descrizione

SessionId

Attributo String obbligatorio che identifica la sessione da utilizzare. Per identificare una sessione, in Analysis Services viene utilizzato un identificatore univoco globale (GUID).

Osservazioni

L'elemento dell'intestazione Session identifica una sessione esistente avviata in modo esplicito nell'istanza di Analysis Services. L'elemento Session fa parte dell'intestazione SOAP nei tipi di messaggi seguenti:

  • Una risposta SOAP che contiene un elemento dell'intestazione SOAP BeginSession.

  • Una richiesta SOAP che identifica la sessione in cui eseguire il metodo Discover o Execute.

Un identificatore di sessione non garantisce che una sessione rimanga valida. La sessione specificata nell'elemento Session può scadere. Una sessione può ad esempio scadere in caso di timeout oppure se la connessione associata alla sessione viene disconnessa. Se la sessione scade e non è più valida, Analysis Services termina la sessione ed esegue il rollback di qualsiasi transazione in corso. Tutti i messaggi SOAP inviati con un identificatore di sessione non più valido hanno esito negativo e viene generato un errore SOAP che indica che non è possibile trovare la sessione specificata.

Se un elemento Session non viene inviato come parte di una richiesta SOAP, l'istanza di Analysis Services avvia in modo implicito una sessione per la durata della chiamata al metodo Discover o Execute, quindi termina la sessione dopo che la chiamata al metodo è stata completata.