• Artikel

Session-Element (XMLA)

Verwendet den SOAP-Header in einer SOAP-Anforderungsnachricht, um eine vorhandene, explizierte Sitzung auf einer Instanz von Microsoft SQL Server Analysis Services zu identifizieren.

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

Syntax

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

Elementmerkmale

Merkmal

Beschreibung

Datentyp und -länge

Keiner

Standardwert

Keiner

Kardinalität

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

Elementbeziehungen

Beziehung

Element

Übergeordnete Elemente

Keine

Untergeordnete Elemente

Keine

Attribute

Attribut

Beschreibung

SessionID

Benötigtes String-Attribut, das die zu nutzende Sitzung identifiziert. Analysis Services verwendet zum Identifizieren einer Sitzung einen global eindeutigen Bezeichner (GUID).

Hinweise

Das Session-Header-Element identifiziert eine vorhandene, explizit gestartet Sitzung auf der Analysis Services-Instanz. Das Session-Element ist in den folgenden Nachrichtentypen Teil des SOAP-Headers:

  • Eine SOAP-Antwort, die ein BeginSession SOAP-Header-Element enthält.

  • Eine SOAP-Anforderung zur Identifikation der Sitzung, auf der die Discover- oder Execute-Methode ausgeführt wird.

Eine Sitzungs-ID garantiert nicht, dass eine Sitzung gültig bleibt. Die im Session-Element angegebene Sitzung kann ablaufen. Eine Sitzung kann beispielsweise ablaufen, wenn das Timeout der Sitzung erreicht ist oder wenn die der Sitzung zugeordnete Verbindung beendet wird. Wenn die Sitzung abläuft und nicht mehr länger gültig ist, beendet Analysis Services die Sitzung und führt für alle derzeit stattfindenden Transaktionen ein Rollback durch. Jede SOAP-Nachricht, die zusammen mit einer nicht mehr gültigen ID gesendet wird, schlägt mit einem SOAP-Fehler fehl, der angibt, dass die angegebene Sitzung nicht gefunden werden kann.

Wenn ein Session-Element nicht als Teil einer SOAP-Anfrage gesendet wird, startet die Analysis Services-Instanz implizit eine Sitzung, deren Dauer des Discover- oder Execute-Methodenaufrufs entspricht. Nach Abschluss des Methodenaufrufs beendet die Instanz die Sitzung.