Élément Session (XMLA)

Utilise l'en-tête SOAP dans un message de demande SOAP pour identifier une session explicite existante 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>
      ...
      <Session
         xmlns="urn:schemas-microsoft-com:xml-analysis"
         SessionId="string" />
      ...
   </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

Attributs

Attribut	Description
SessionId	Attribut String obligatoire qui identifie la session à employer. Analysis Services fait appel à un identificateur global unique (GUID) pour identifier une session.

Notes

L'élément d'en-tête Session identifie une session existante démarrée explicitement sur l'instance Analysis Services. L'élément Session fait partie de l'en-tête SOAP dans les types de messages suivants :

• Une réponse SOAP contenant un élément d'en-tête SOAP BeginSession.

• Une demande SOAP permettant d'identifier la session sur laquelle exécuter la méthode Discover ou Execute.

Un identificateur de session ne garantit pas qu'une session reste valide. La session spécifiée dans l'élément Session peut expirer. Par exemple, une session peut expirer si la session dépasse le délai d'attente imparti ou si la connexion associée à la session est fermée. Si la session arrive à expiration et n'est plus valide, Analysis Services y met un terme et restaure toutes les transactions en cours de traitement. Tous les messages SOAP transmis avec un identificateur de session qui n'est plus valide échouent avec une erreur SOAP indiquant que la session spécifiée est introuvable.

Si un élément Session n'est pas envoyé dans le cadre d'une demande SOAP, l'instance Analysis Services lance implicitement une session pendant la durée de l'appel de méthode Discover ou Execute, puis met fin à la session une fois l'appel de méthode terminé.

Voir aussi

Référence

Élément EndSession (XMLA)

Concepts

Gestion des connexions et des sessions (XMLA)

Autres ressources

En-têtes [XMLA]