Surveillance de traces (XMLA)
Vous pouvez utiliser la commande Subscribe de XMLA (XML for Analysis) pour surveiller une trace existante définie sur une instance de Microsoft SQL Server Analysis Services. La commande Subscribe retourne les résultats d'une trace sous la forme d'un 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 Analysis Services ou à une trace au niveau d'une instance Analysis Services. Si la propriété Object n'est pas spécifiée ou si aucun identificateur de trace n'y est Object spécifié, 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 des résultats de trace tant que la la commande n'a pas été 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 |
Entier |
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, si elle est disponible. 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 |
Chaîne |
Identificateur de la session pour laquelle l'événement s'est produit. |
SessionType |
Chaîne |
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 |
Chaîne |
Identificateur de l'objet pour lequel l'événement s'est produit. |
ObjectType |
Chaîne |
Type de l'objet spécifié dans ObjectName. |
ObjectName |
Chaîne |
Nom de l'objet pour lequel l'événement s'est produit. |
ObjectPath |
Chaîne |
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 |
Chaîne |
Représentation XML de la référence de l'objet spécifié dans ObjectName. |
NestLevel |
Entier |
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. |
Severity |
Entier |
Niveau de gravité d'une exception relative à l'événement. La colonne peut contenir l'une des valeurs suivantes :
ValeurDescription
0Succès
1Information
2Avertissement
3Erreur
|
Success |
Booléen |
Indique si une commande a abouti ou échoué. |
Error |
Entier long |
Numéro d'erreur de l'événement, le cas échéant. |
ConnectionID |
Chaîne |
Identificateur de la connexion pour laquelle l'événement s'est produit. |
DatabaseName |
Chaîne |
Nom de la base de données pour laquelle l'événement s'est produit. |
NTUserName |
Chaîne |
Nom d'utilisateur Windows de l'utilisateur associé à l'événement. |
NTDomainName |
Chaîne |
Domaine Windows de l'utilisateur associé à l'événement. |
ClientHostName |
Chaîne |
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 |
Chaîne |
Nom de l'application cliente qui a créé la connexion à l'instance Analysis Services. Cette colonne est remplie des valeurs transmises par l'application cliente et non du nom affiché du programme. |
NTCanonicalUserName |
Chaîne |
Nom d'utilisateur canonique Windows de l'utilisateur associé à l'événement. |
SPID |
Chaîne |
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 |
Chaîne |
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 |
Chaîne |
Nom de l'instance Analysis Services pour laquelle l'événement s'est produit. |
RequestParameters |
Chaîne |
Paramètres de la requête paramétrable ou de la commande XMLA pour laquelle l'événement s'est produit. |
RequestProperties |
Chaîne |
Propriétés de la méthode XMLA pour laquelle l'événement s'est produit. |