Elemento Session (XMLA)
Utilizza l'intestazione SOAP in un messaggio di richiesta SOAP per identificare una sessione esplicita esistente in un'istanza di Analysis Services.
Namespace urn:schemas-microsoft-com:xml-analysis
Sintassi
<soap:Envelope xmlns:soap="http://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 degli elementi
| Caratteristica | Descrizione |
|---|---|
| Tipo di dati e lunghezza | Nessuno |
| Valore predefinito | Nessuno |
| Cardinalità | 0-1: elemento facoltativo che può ricorrere una sola volta. |
Relazioni tra elementi
| Relazione | Elemento |
|---|---|
| Elementi padre | Nessuno |
| Elementi figlio | Nessuno |
Attributi
| Attributo | Descrizione |
|---|---|
| SessionId | Attributo String obbligatorio che identifica la sessione da usare. L'istanza del server utilizza un identificatore univoco globale (GUID) per identificare una sessione. |
Commenti
L'elemento intestazione Session identifica una sessione avviata in modo esplicito nell'istanza di . L'elemento Session fa parte dell'intestazione SOAP nei tipi di messaggi seguenti:
Risposta SOAP che contiene un elemento di intestazione SOAP BeginSession.
Richiesta SOAP per identificare 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, il server termina la sessione ed esegue il rollback di qualsiasi transazione attualmente 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 avvia in modo implicito una sessione per la durata della chiamata al metodo Discover o Execute e quindi termina la sessione al termine della chiamata al metodo.