Élément Cancel (XMLA)
Annule une commande en cours d'exécution dans une instance MicrosoftSQL ServerAnalysis Services.
Syntaxe
<Command>
<Cancel>
<ConnectionID>...</ConnectionID>
<SessionID>...</SessionID>
<SPID>...</SPID>
<CancelAssociated>...</CancelAssociated>
</Cancel>
</Command>
Caractéristiques de l'élément
Caractéristique |
Description |
|---|---|
Type de données et longueur |
Aucun |
Valeur par défaut |
Aucune |
Cardinalité |
0-n : élément facultatif susceptible d'apparaître plusieurs fois. |
Relations entre les éléments
Relation |
Élément |
|---|---|
Éléments parents |
|
Éléments enfants |
Notes
La commande Cancel annule les commandes en cours d'exécution dans le contexte d'une session. Si l'application cliente n'a demandé aucune session, une commande ne peut être annulée.
Si l'exécution de la commande Cancel a lieu pendant celle d'une commande Batch, la commande Batch tout entière est annulée. Si la commande Batch était transactionnelle, toutes les commandes que contient la commande Batch sont restaurées. Si la commande Batch n'était pas transactionnelle, seules les commandes figurant dans la commande Batch et exécutées au moment de l'exécution de la commande Cancel sont restaurées. Les commandes incluses dans une commande Batch non transactionnelle et qui ont déjà été exécutées ne sont pas restaurées.
En règle générale, la commande Cancel est utilisée pour annuler l'exécution des commandes dans la session active. Dans ce cas, aucun des éléments enfants de la commande Cancel ne doit être spécifié. Les administrateurs peuvent également faire appel à la commande Cancel pour annuler des commandes exécutées sur des connexions ou des sessions autres que la session active. Les membres d'un rôle qui bénéficie d'autorisations d'administration pour une base de données spécifique peuvent annuler des commandes pour des connexions et des sessions applicables à cette base de données, tandis que les administrateurs de serveur peuvent annuler des commandes pour les connexions et les sessions d'une instance Analysis Services donnée.
Pour récupérer des informations sur les connexions et les sessions en cours d'une instance Analysis Services, vous pouvez exécuter la méthode Discover pour demander, respectivement, les ensembles de lignes de schéma DISCOVER_CONNECTIONS et DISCOVER_SESSIONS. Les membres d'un rôle qui bénéficie d'autorisations d'administration pour une base de données spécifique peuvent retourner des sessions uniquement pour une base de données donnée en précisant cette base de données dans la colonne de restriction SESSION_CURRENT_DATABASE pour l'ensemble de lignes de schéma DISCOVER_SESSIONS. Pour plus d'informations sur la méthode Discover, consultez Méthode Discover (XMLA).