Partager via


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

Caractéristiques de l'élément

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

Relation

Élément

Éléments parents

Aucun

Éléments enfants

Aucun

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.