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.
Siehe auch