Share via

  • Artikel

BeginSession-Element (XMLA)

Verwendet einen SOAP-Header in einer SOAP-Anforderungsnachricht, um eine neue Sitzung auf einer Instanz von MicrosoftSQL ServerAnalysis Services zu starten.

Namespace urn:schemas-microsoft-com:xml-analysis

Syntax

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

Elementmerkmale

Merkmal

Beschreibung

Datentyp und -länge

Keine

Standardwert

Keiner

Kardinalität

0-1: Optionales Element, das nur einmal auftreten kann.

Elementbeziehungen

Beziehung

Element

Übergeordnete Elemente

Keine

Untergeordnete Elemente

Keine

Hinweise

Das BeginSession-Headerelement ist Teil einer SOAP-Anforderung, die an eine Analysis Services-Instanz gesendet wurde, und startet explizit eine neue Sitzung auf einer Instanz. Der von der SOAP-Antwort zurückgegebene SOAP-Header enthält ein Session-Element, das die neue Sitzung identifiziert. Dieser neue Sitzungsbezeichner wird gespeichert und in nachfolgende SOAP-Anforderungen mit dem Session-Headerelement gesendet.

Wenn das BeginSession-Headerelement nicht gesendet wird, wird keine Sitzung explizit gestartet. Wenn eine Sitzung nicht explizit gestartet wird, können Transaktionen auf dieser Sitzung nicht verwaltet werden. Mit anderen Worten, Sie können die folgenden XMLA-Befehle (XML for Analysis) nicht verwenden: BeginTransaction, CommitTransaction und RollbackTransaction. Alle XMLA-Methoden und -Befehle, die auf einer implizit gestarteten Sitzung ausgeführt werden, werden als unteilbare Transaktionen angesehen.