Verwalten von Verbindungen und Sitzungen (XMLA)

Zustandserlädung ist eine Bedingung, bei der der Server die Identität und den Kontext eines Clients zwischen Methodenaufrufen bei behält. Zustandserlädung ist eine Bedingung, bei der sich der Server nach Abschluss eines Methodenaufrufs nicht an die Identität und den Kontext eines Clients erinnern kann.

Um zustandserfüllte XML for Analysis (XMLA) zu ermöglichen, werden Sitzungen unterstützt, die die gemeinsame Ausführung einer Reihe von Anweisungen ermöglichen. Ein Beispiel einer solchen Reihe von Anweisungen ist die Erstellung eines berechneten Elements, das in nachfolgenden Abfragen verwendet wird.

Im Allgemeinen folgen Sitzungen in XMLA dem folgenden Verhalten gemäß der Spezifikation OLE DB 2.6:

• Sitzungen definieren Transaktion und Befehlskontextbereich.

• Mehrere Befehle können im Kontext einer einzelnen Sitzung ausgeführt werden.

• Die Unterstützung für Transaktionen im XMLA-Kontext erfolgt über anbieterspezifische Befehle, die mit der Execute-Methode gesendet werden.

XMLA definiert eine Möglichkeit zur Unterstützung von Sitzungen in einer Webumgebung, deren Modus Ähnlichkeit hat mit dem Zugang, der von dem DAV-Protokoll (Distributed Authoring and Versioning) für die Implementierung von Sperrungen in einer lose verbundenen Umgebung verwendet wird. Diese Implementierung entspricht DAV insofern, als der Anbieter die Möglichkeit hat, Sitzungen aus mehreren Gründen ablaufen zu lassen (beispielsweise bei Timeout oder Verbindungsfehlern). Wenn Sitzungen unterstützt werden, müssen Webdienste in der Lage sein, unterbrochene Befehlssätze, die neu gestartet werden müssen, zu verarbeiten.

Die Spezifikation des Simple Object Access Protocol (SOAP) des World Wide Web Consortium (W3C) empfiehlt die Verwendung von SOAP-Headern für die Erstellung von neuen Protokollen auf der Grundlage von SOAP-Nachrichten. In der folgenden Tabelle werden die SOAP-Headerelemente und -attribute aufgeführt, die XMLA für die Initiierung, Erhaltung und Beendigung von Sitzungen definiert.

SOAP-Header	BESCHREIBUNG
BeginSession	Dieser Header fordert bei dem Anbieter die Erstellung einer neuen Sitzung an. Der Anbieter sollte mit der Erstellung einer neuen Sitzung antworten und die Sitzungs-ID als Teil des Sitzungsheaders in der SOAP-Antwort zurückgeben.
SessionID	Der Wertbereich enthält die Sitzungs-ID, die für den Rest der Sitzung in jedem Methodenaufruf verwendet werden muss. Der Anbieter sendet dieses Tag in der SOAP-Antwort, und der Client muss dieses Attribut ebenfalls mit jedem Sitzungsheaderelement senden.
Sitzung	Dieser Header muss für jeden Methodenaufruf in der Sitzung verwendet werden, und die Sitzungs-ID muss im Wertbereich des Headers enthalten sein.
EndSession	Verwenden Sie diesen Header, um die Sitzung zu beenden. Die Sitzungs-ID muss im Wertbereich enthalten sein.

Hinweis

Eine Sitzungs-ID garantiert nicht, dass eine Sitzung gültig bleibt. Wenn eine Sitzung abläuft (beispielsweise bei einem Timeout oder wenn die Verbindung verloren geht), kann der Anbieter die Aktionen der Sitzung beenden und rückgängig machen. Als Ergebnis führen alle nachfolgenden Methodenaufrufe des Clients mit der Sitzungs-ID zu einem Fehler, der angibt, dass die Sitzung ungültig ist. Ein Client sollte diese Bedingung handhaben können und in der Lage sein, die Methodenaufrufe der Sitzung von Anfang an erneut zu senden.

Legacy-Codebeispiel

Im folgenden Beispiel wird gezeigt, wie Sitzungen unterstützt werden.

1. Fügen Sie dem ausgehenden XMLA-Methodenaufruf des Clients einen BeginSession-Header in SOAP hinzu, um eine Sitzung zu beginnen. Der Wertbereich ist zunächst leer, da die Sitzungs-ID noch nicht bekannt ist.

   <SOAP-ENV:Envelope  
      xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
      SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">  
      <SOAP-ENV:Header>  
         <XA:BeginSession  
            xmlns:XA="urn:schemas-microsoft-com:xml-analysis"  
            xsi:type="xsd:int"  
            mustUnderstand="1"/>  
      </SOAP-ENV:Header>  
      <SOAP-ENV:Body>  
         ...<!-- Discover or Execute call goes here.-->  
      </SOAP-ENV:Body>  
   </SOAP-ENV:Envelope>  
   

2. Die SOAP-Antwortnachricht des Anbieters enthält die Sitzungs-ID im Rückgabeheaderbereich unter Verwendung des XMLA-Headertags <SessionId>.

   <SOAP-ENV:Header>  
      <XA:Session  
         xmlns:XA="urn:schemas-microsoft-com:xml-analysis"  
         SessionId="581"/>  
   </SOAP-ENV:Header>  
   

3. Für jeden Methodenaufruf in der Sitzung muss der Sitzungsheader hinzugefügt werden, der die vom Anbieter zurückgegebene Sitzungs-ID enthält.

   <SOAP-ENV:Header>  
      <XA:Session  
         xmlns:XA="urn:schemas-microsoft-com:xml-analysis"  
         mustUnderstand="1"  
         SessionId="581"/>  
   </SOAP-ENV:Header>  
   

4. Wenn die Sitzung abgeschlossen ist, wird das <EndSession-Tag> verwendet, das den zugehörigen Sitzungs-ID-Wert enthält.

   <SOAP-ENV:Header>  
      <XA:EndSession  
         xmlns:XA="urn:schemas-microsoft-com:xml-analysis"  
         xsi:type="xsd:int"  
         mustUnderstand="1"  
         SessionId="581"/>  
   </SOAP-ENV:Header>  
   

Weitere Informationen

Entwickeln mit XMLA in Analysis Services