Surveillance de traces (XMLA)

Vous pouvez utiliser la commande Subscribe dans XML for Analysis (XMLA) pour surveiller une trace existante définie sur une instance de Microsoft SQL Server SQL Server Analysis Services. La commande Subscribe retourne les résultats d’une trace sous forme d’ensemble de lignes.

Spécification d'une trace

La propriété Object de la commande Subscribe doit contenir une référence d’objet à une instance SQL Server Analysis Services ou à une trace sur une instance de SQL Server Analysis Services. Si la propriété Object n’est pas spécifiée ou qu’un identificateur de trace n’est pas spécifié dans la propriété Object , la commande Subscribe surveille la trace de session par défaut pour la session explicite spécifiée dans l’en-tête SOAP de la commande.

Retour de résultats

La commande Subscribe retourne un ensemble de lignes contenant les événements de trace capturés par la trace spécifiée. La commande Subscribe retourne les résultats de trace jusqu’à ce que la commande soit annulée par la commande Cancel .

Cet ensemble de lignes se compose des colonnes répertoriées dans le tableau suivant.

Colonne	Type de données	Description
EventClass	Integer	Classe d'événements de l'événement reçu par la trace.
EventSubclass	Entier long	Sous-classe d'événements de l'événement reçu par la trace.
CurrentTime	Datetime	Heure de début de l'événement, le cas échéant. Pour le filtrage, les formats attendus sont « YYYY-MM-DD » et « YYYY-MM-DD HH:MM:SS ».
StartTime	Datetime	Heure de début de l'événement, le cas échéant. Pour le filtrage, les formats attendus sont « YYYY-MM-DD » et « YYYY-MM-DD HH:MM:SS ».
EndTime	Datetime	Heure de fin de l'événement, si elle est disponible. Pour le filtrage, les formats attendus sont « YYYY-MM-DD » et « YYYY-MM-DD HH:MM:SS ». Cette colonne n'est pas remplie pour les classes d'événements qui décrivent le lancement d'un processus ou d'une action.
Duration	Entier long	Durée totale (en millisecondes) de l'événement.
CPUTime	Entier long	Temps processeur total (en millisecondes) écoulé pour l'événement.
JobID	Entier long	Identificateur de travail du processus.
SessionID	String	Identificateur de la session pour laquelle l'événement s'est produit.
SessionType	String	Type de la session pour laquelle l'événement s'est produit.
ProgressTotal	Entier long	Nombre total ou progression signalé par l'événement.
IntegerData	Entier long	Données entières associées à l'événement. Le contenu de cette colonne dépend de la classe et de la sous-classe d'événements de l'événement.
ObjectID	String	Identificateur de l'objet pour lequel l'événement s'est produit.
ObjectType	String	Type de l'objet spécifié dans ObjectName.
ObjectName	String	Nom de l'objet pour lequel l'événement s'est produit.
ObjectPath	String	Chemin d'accès hiérarchique de l'objet pour lequel l'événement s'est produit. Le chemin d'accès est représenté par une chaîne délimitée par des virgules correspondant aux identificateurs d'objet des parents de l'objet spécifiés dans ObjectName.
ObjectReference	String	Représentation XML de la référence de l'objet spécifié dans ObjectName.
NestLevel	Integer	Niveau de la transaction pour laquelle l'événement s'est produit.
NumSegments	Entier long	Nombre de segments de données affectés ou atteints par la commande pour laquelle l'événement s'est produit.
Gravité	Integer	Niveau de gravité d'une exception relative à l'événement. La colonne peut contenir l'une des valeurs suivantes : 0 : Réussite 1 : Informations 2 : Avertissement 3 : Erreur
Succès	Booléen	Indique si une commande a abouti ou échoué.
Erreur	Entier long	Numéro d'erreur de l'événement, le cas échéant.
ConnectionID	String	Identificateur de la connexion pour laquelle l'événement s'est produit.
nom_base_de_données	String	Nom de la base de données pour laquelle l'événement s'est produit.
NTUserName	String	Nom d'utilisateur Windows de l'utilisateur associé à l'événement.
NTDomainName	String	Domaine Windows de l'utilisateur associé à l'événement.
ClientHostName	String	Nom de l'ordinateur sur lequel l'application cliente est exécutée. Cette colonne est remplie des valeurs transmises par l'application cliente.
ClientProcessID	Entier long	Identificateur de processus de l'application cliente.
ApplicationName	String	Nom de l’application cliente qui a créé la connexion à l’instance SQL Server Analysis Services. Cette colonne est remplie des valeurs transmises par l'application cliente et non du nom affiché du programme.
NTCanonicalUserName	String	Nom d'utilisateur canonique Windows de l'utilisateur associé à l'événement.
SPID	String	ID de processus serveur (SPID) de la session pour laquelle l'événement s'est produit. La valeur de cette colonne correspond directement à l'ID de session spécifié dans l'en-tête SOAP du message XMLA pour lequel l'événement s'est produit.
TextData	String	Données texte associées à l’événement. Le contenu de cette colonne dépend de la classe et de la sous-classe d'événements de l'événement.
ServerName	String	Nom de l’instance SQL Server Analysis Services pour laquelle l’événement s’est produit.
RequestParameters	String	Paramètres de la requête paramétrable ou de la commande XMLA pour laquelle l'événement s'est produit.
RequestProperties	String	Propriétés de la méthode XMLA pour laquelle l'événement s'est produit.

Voir aussi

Développement avec XMLA dans Analysis Services