Élément BeginSession (XMLA)
Utilise un en-tête SOAP dans un message de demande SOAP pour démarrer une nouvelle session sur une instance de Microsoft SQL Server Analysis Services.
Espace de noms urn:schemas-microsoft-com:xml-analysis
Syntaxe
<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>
Element Characteristics
Caractéristique |
Description |
---|---|
Type de données et longueur |
Aucun |
Valeur par défaut |
Aucune |
Cardinalité |
0-1 : élément facultatif qui peut apparaître une fois et une seule. |
Relations entre les éléments
Relationship |
Élément |
---|---|
Éléments parents |
Aucun |
Éléments enfants |
None |
Notes
L'élément d'en-tête BeginSession fait partie d'une demande SOAP envoyée à une instance Analysis Services et démarre explicitement une nouvelle session sur cette instance. L'en-tête SOAP retourné par la réponse SOAP contient un élément Session qui identifie la nouvelle session. Ce nouvel identificateur de session peut être stocké et envoyé dans les demandes SOAP suivantes à l'aide de l'élément d'en-tête Session.
Si l'élément d'en-tête BeginSession n'est pas envoyé, aucune session n'est démarrée explicitement. Si une session n'est pas démarrée explicitement, les transactions sur cette session ne peuvent pas être gérées. En d'autres termes, vous ne pouvez pas utiliser les commandes XMLA (XML for Analysis) suivantes : BeginTransaction, CommitTransactionet RollbackTransaction. Toutes les méthodes et les commandes XMLA exécutées sur une session démarrée implicitement sont considérées comme des transactions atomiques.
Voir aussi
Référence
Concepts
Gestion des connexions et des sessions (XMLA)