Condividi tramite


Elemento BeginSession (XMLA)

Utilizza un'intestazione SOAP in un messaggio di richiesta SOAP per avviare una nuova sessione 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>
      ...
      <BeginSession
         xmlns="urn:schemas-microsoft-com:xml-analysis" />
      ...
   </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

Osservazioni

L'elemento dell'intestazione BeginSession fa parte di una richiesta SOAP inviata a un'istanza di Analysis Services e avvia in modo esplicito una nuova sessione nell'istanza. L'intestazione SOAP restituita dalla risposta SOAP contiene un elemento Session che identifica la nuova sessione. Questo identificatore della nuova sessione verrà archiviato e inviato nelle richieste SOAP successive utilizzando l'elemento dell'intestazione Session.

Se l'elemento dell'intestazione BeginSession non viene inviato, una sessione non verrà avviata in modo esplicito. Se una sessione non viene avviata in modo esplicito, non sarà possibile gestire le transazioni nella sessione. In altri termini, non sarà possibile utilizzare i comandi XMLA (XML for Analysis) seguenti: BeginTransaction, CommitTransaction e RollbackTransaction. Tutti i metodi e i comandi XMLA eseguiti in una sessione avviata in modo implicito vengono considerati transazioni atomiche.