• Article

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