Élément Cancel (XMLA)

Article
05/08/2023

Annule une commande en cours d’exécution d’une instance de Analysis 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	None
Valeur par défaut	None
Cardinalité	0-n : élément facultatif pouvant apparaître plusieurs fois.

Relations d’éléments

Relation	Élément
Éléments parents	Commande
Éléments enfants	CancelAssociated, ConnectionID, SessionID, SPID

Remarques

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 actuelles pour une instance de Analysis Services, la méthode Discover peut être exécutée 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 Discover, méthode (XMLA).

Partager via