Partager via

Examiner les résultats du replay

S’applique à : SQL Server 2016 (13.x), SQL Server 2017 (14.x) et SQL Server 2019 (15.x)

Important

SQL Server Distributed Replay n’est pas disponible avec SQL Server 2022 (16.x) et versions ultérieures.

Une fois que la fonctionnalité Microsoft SQL Server Distributed Replay a terminé une relecture distribuée, l’activité de relecture de chaque client peut être capturée et enregistrée dans des fichiers de trace de résultats sur chaque client. Pour capturer cette activité, vous devez utiliser le paramètre -o quand vous exécutez l’outil d’administration avec l’option replay . Pour plus d’informations sur l’option replay, consultez Option replay (outil d’administration Distributed Replay).

L'emplacement où sont stockés les fichiers de trace de résultats est spécifié par l'élément XML <ResultDirectory> dans le fichier de configuration client, DReplayClient.xml, situé sur chaque client. Les fichiers de trace dans le répertoire des résultats du client sont remplacés à chaque relecture.

Pour spécifier le genre de sortie à capturer dans les fichiers de trace de résultats, modifiez le fichier config de relecture, DReplay.exe.replay.config. Vous pouvez utiliser l'élément XML <OutputOptions> pour spécifier si le nombre de lignes ou le contenu du jeu de résultats doit être enregistré.

Pour plus d’informations sur ces paramètres de configuration, consultez Configurer Distributed Replay.

Classes d'événements capturées dans les fichiers de trace de résultats

Le tableau suivant répertorie toutes les classes d'événements capturées dans les données de trace de résultats.

Catégorie Nom de la classe d'événements Fréquence de capture Point de capture
Événements pouvant être relus Auditer la connexion Une fois pour chaque événement Audit Login dans les données de trace d’origine Après la réussite ou l'échec de l'événement
Déconnexion liée à l'audit Une fois pour chaque événement Audit Logout dans les données de trace d’origine Après la réussite ou l'échec de l'événement
SQL : BatchCompleted Une fois pour chaque événement SQL:BatchStarting dans les données de trace d'origine Après la réussite ou l'échec de l'événement
RPC : Terminé Une fois pour chaque événement RPC:Starting dans les données de trace d’origine Après la réussite ou l'échec de l'événement
Statistiques et résultats Paramètres de Rediffusion Événement ** Une fois Premier événement de la trace de résultats
Événement de rediffusion des statistiques ** Une fois Dernier événement de la trace de résultats.
Relecture de l'événement Result Set Une fois pour chaque événement SQL:BatchStarting et RPC:Starting.

Uniquement capturé si la valeur de l'option <RecordResultSet> dans le fichier de configuration de réexécution a été définie sur Yes.
Rejouer l'événement de la ligne de résultat Une fois pour chaque ligne dans le jeu de résultats des événements SQL:BatchStarting et RPC:Starting.

Uniquement capturé si la valeur de l'option <RecordResultSet> dans le fichier de configuration de réexécution a été définie sur Yes.
Erreurs et avertissements Erreur interne de relance Une fois pour chaque erreur interne En cas de condition d’erreur interne
Erreur du fournisseur de lecture Une fois pour chaque erreur de fournisseur En cas de condition d’erreur de fournisseur

Notez les points suivants :

  • Pour chaque événement relu avec succès sur le serveur cible, il existe une classe d'événement de sortie correspondante.

  • Pour chaque échec ou annulation d'événement, plusieurs erreurs peuvent être générées.

Mappage de colonne de la classe d’événements

La figure suivante répertorie les colonnes de trace de résultats disponibles pour chaque type de classe d'événements capturée lors de la relecture.

Mappage de colonne de la classe d’événements

Descriptions des colonnes de la trace de résultats

Le tableau suivant décrit les colonnes des données de la trace de résultats.

Nom de la colonne de données Type de données Descriptif ID de la colonne
EventClass nvarchar Nom de la classe d'événement. 1
Séquence d'événements bigint Pour les erreurs de fournisseur, les erreurs internes et les avertissements, il s'agit de la séquence de l'événement de capture qui correspond à l'erreur ou à l'avertissement.

Pour toutes les autres classes d'événements, il s'agit de la séquence de l'événement dans les données de trace d'origine.		 2
ReplaySequence bigint Pour les erreurs de fournisseur, les erreurs internes et les avertissements, il s’agit de la séquence de l’événement de relecture qui correspond à l’erreur ou à l’avertissement.

Pour toutes les autres classes d’événements, il s’agit de la séquence de l’événement affecté pendant la relecture.		 3
Données textuelles context Le contenu de TextData dépend de l'EventClass.

Pour Audit Login et ExistingConnection, il s'agit des options définies pour la connexion.

Pour SQL:BatchStarting, c'est le corps de la requête par lot.

Pour RPC:Starting, c'est la procédure stockée qui a été appelée.

Pour Replay Settings Event, cette colonne contient les paramètres définis dans le fichier config de relecture.

Pour Replay Statistics Event, il contient les informations suivantes :

– Serveur SQL cible de relecture

– Nombre total d’événements pouvant être relus

-nombre d’erreurs de fournisseur ;

-nombre d’erreurs internes ;

-avertissements internes ;

-nombre total d’erreurs ;

-taux global de réussite ;

– Heure de relecture (HH:MM:SS:MMM)

Pour Replay Result Set Event, il affiche la liste des en-têtes de colonne de résultats retournés.

Pour Replay Result Row Event, il affiche la valeur de retour de toutes les colonnes de cette ligne.

Pour Replay Internal Warning et Replay Provider Error, cette colonne contient les avertissements ou les erreurs de fournisseur.		 4
Attention bigint La durée d'attention (en microsecondes) pour l'événement. Elle est calculée à partir de l’événement Attention de la trace de capture. Si aucun délai de requête n'a été spécifié pour l'événement, cette colonne n'est pas remplie (Null). 5
Heure de soumission datetime Heure à laquelle l'événement a été soumis à SQL Server. 6
EstRéussi Int Indicateur booléen qui indique si un événement particulier a été exécuté avec succès et si les jeux de résultats ont été retournés au côté client.

Un événement qui génère un avertissement (comme lorsqu’un événement est annulé en raison d’un événement Attention ou d’un délai d’expiration spécifié par l’utilisateur) est considéré comme réussi.

IsSuccessful peut prendre l'une des valeurs suivantes :

1 = Réussi

0 = Échec		 7
Durée [microsec] bigint Durée de temps de réponse (en microsecondes) pour l'événement. La mesure démarre au moment où l'événement d'ouverture de session/de fermeture de session/RPC/événement de langue a été soumis à SQL Server.

Si l'événement réussit, la mesure se termine lorsque le jeu de résultats complet a été consommé.

Si l'événement ne réussit pas, la mesure se termine au moment de l'échec ou de l'annulation de l'événement.		 8
RowCount bigint Rempli selon la valeur de <RecordRowCount> dans le fichier config de relecture :

Si <RecordRowCount> est égal à Oui, cette cellule contient le nombre de lignes dans le jeu de résultats retournées par SQL Server.

Si <RecordRowCount> est égal à Non, cette cellule n'est pas remplie (Null).		 9
CaptureSPID Int ID de la session de capture de l'événement. 10
Identifiant de connexion Int ID de la connexion de capture de l’événement. 11
ReplaySPID Int ID de la session de relecture de l’événement. 12
Nom de la base de données nvarchar Nom de la base de données dans laquelle l'instruction de l'utilisateur est exécutée. 13
Nom d'utilisateur nvarchar Nom de connexion de l'utilisateur. Il peut s’agir soit d’une connexion de sécurité SQL Server , soit des informations d’identification de connexion Microsoft Windows, au format nom_domaine\nom_utilisateur. 14
Nom d'hôte de capture nvarchar Nom de l'ordinateur sur lequel s'exécute le service client lors de la capture. 15
ReplayHostName nvarchar Nom de l’ordinateur sur lequel le client s’exécute pendant la relecture. 16
Nom de l'application nvarchar Nom de l'application cliente qui a créé la connexion SQL Server lors de la capture. 17

Voir aussi