Afficher les données d’événement dans SQL Server Management Studio

  • Article

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

Cet article explique comment utiliser SQL Server Management Studio (SSMS) pour afficher les données cibles à partir d’événements étendus. Cet article explique comment :

  • ouvrir et afficher les données cibles de différentes manières ;
  • Exportez les données cibles dans différents formats à l’aide du menu spécial ou de la barre d’outils pour les événements étendus.
  • manipuler les données pendant la consultation ou avant l’exportation. Vous pouvez afficher, exporter, filtrer et agréger des données d’événement.

Prérequis

Cet article considère que vous savez déjà créer et démarrer une session d’événements. Des instructions sur la façon de créer une session d’événements sont fournies au début de l’article suivant :

Démarrage rapide : Événements étendus

Nous vous recommandons d’utiliser une version récente de SSMS. Téléchargez-le à partir de Télécharger SQL Server Management Studio (SSMS).

Différences par rapport à la Base de données SQL Azure

Il existe certaines différences entre les événements étendus dans SQL Server et dans Azure SQL Database.

  • Pour Azure SQL Database, la event_file cible ne peut pas être un fichier sur le lecteur de disque local. Au lieu de cela, vous devez utiliser un conteneur de stockage Azure. Lorsque vous êtes connecté à la base de données dans Azure SQL Database, l’interface utilisateur SSMS demande un conteneur de stockage, au lieu d’un chemin d’accès local et d’un nom de fichier.
  • Dans l’interface utilisateur de SSMS, regardez les données actives désactivées. Cela est dû au fait que cette fonctionnalité n’est pas disponible pour Azure SQL Database.
  • Quelques sessions d’événements étendus sont installées avec SQL Server, par exemple la system_health session. Ces sessions ne sont pas disponibles pour Azure SQL Database.

Cet article a été rédigé du point de vue de SQL Server. L’article utilise la event_file cible, qui est implémentée différemment dans les événements étendus pour SQL Server et pour Azure SQL Database.

Pour obtenir de la documentation sur les événements étendus spécifiques à Azure SQL Database, consultez Événements étendus dans Azure SQL Database.

Ouvrir l’interface utilisateur de l’observateur d’événements SSMS

L’interface utilisateur de l’observateur d’événements SSMS est accessible de l’une des manières suivantes :

  • Fichier>d’ouverture>de fichier de menu principal, puis recherchez un fichier xel
  • Cliquez avec le bouton droit sur les événements étendus dans la gestion de l’Explorateur > d’objets
  • Menu Événements étendus et barre d’outils Événements étendus
  • Clics droit dans le volet à onglets qui affiche les données cibles

Afficher les données event_file dans SSMS

Il existe différentes façons d’afficher les event_file données cibles dans l’interface utilisateur de SSMS. Lorsque vous spécifiez une event_file cible, vous définissez son chemin d’accès et son nom de fichier, y compris l’extension xel .

  • Chaque fois que la session d’événements est démarrée, les événements étendus ajoutent un suffixe numérique au nom de fichier pour rendre le nom de fichier unique.
    • Exemple : Checkpoint_Begins_ES_0_131103935140400000.xel
  • xel les fichiers sont des fichiers binaires. Ils ne doivent pas être ouverts dans un éditeur de texte tel que Bloc-notes Windows.
    • Utilisez la boîte de dialogue File>Open>Merge Extended Event Files pour ouvrir plusieurs fichiers d’événements dans l’interface utilisateur de l’observateur d’événements SSMS.

SSMS peut afficher des données pour la plupart des cibles d’événements étendus. Mais les affichages sont différents pour les différentes cibles. Par exemple :

  • event_file : les données d’une cible event_file s’affichent dans l’observateur d’événements, avec filtrage, agrégation et autres fonctionnalités disponibles.
  • ring_buffer : les données d’une cible de mémoire tampon en anneau sont affichées en tant que XML.

SSMS ne peut pas afficher les données de la etw_classic_sync_target cible.

Ouvrir un fichier xel à l’aide > d’un fichier ouvert > de fichier

Vous pouvez ouvrir un fichier unique xel à partir du menu principal de SSMS, à l’aide du fichier ouvert>de fichier.> Vous pouvez également faire glisser-déplacer un xel fichier dans SSMS.

Afficher les données cibles

L’option Afficher les données cibles affiche les données qui ont été capturées jusque-là. Dans l’Explorateur d’objets, vous pouvez développer les nœuds, puis cliquer avec le bouton droit :

  • Gestion>Événements étendus>Sessions>[votre-session]>[votre-nœud-cible]>Afficher les données cibles.

Les données cibles sont affichées dans un volet à onglets dans SSMS comme suit :

Screenshot of your target > View Target Data.

Remarque

Afficher les données cibles affiche les données de tous les xel fichiers associés aux sessions. Chaque cycle d’arrêt de démarrage-crée un fichier avec une valeur numérique dérivée ultérieurement ajoutée au nom de fichier, mais chaque fichier partage le même nom racine. Des fichiers de substitution xel supplémentaires sont également créés lorsque la taille du fichier dépasse la taille maximale spécifiée avec le MAX_FILE_SIZE paramètre.

Regarder les données en direct

Lorsque votre session d’événements est en cours d’exécution, vous pouvez regarder les données d’événement en temps réel, car elles sont reçues par la cible.

  • Gestion>Événements étendus>Sessions>[votre-session]>Surveiller les données actives.

Screenshot of your session > Watch Live Data.

L’affichage des données est mis à jour à intervalles réguliers que vous pouvez spécifier au niveau du paramètre Latence maximale de répartition dans :

  • Événements étendus>Sessions>[votre-session]>Propriétés>Avancé>Latence maximale de répartition

Afficher les données d’événement avec la fonction sys.fn_xe_file_target_read_file()

La fonction sys.fn_xe_file_target_read_file() retourne un ensemble de lignes avec chaque ligne représentant un événement capturé. Les données d’événement sont retournées au format XML. XQuery peut être utilisé pour présenter des données d’événement relationnellement.

Exporter des données cibles

Une fois que vous avez des données d’événement affichées dans l’observateur d’événements SSMS, vous pouvez l’exporter dans différents formats en procédant comme suit :

Screenshot of exporting displayed data, Extended Events > Export to.

  1. Sélectionnez Événements étendus dans le menu principal.
  2. Sélectionnez Exporter vers, puis choisissez un format.

Manipuler les données dans l’affichage

Au-delà de la simple consultation des données telles quelles, l’interface utilisateur de SSMS vous permet de manipuler les données de différentes manières.

Menus contextuels dans l’affichage des données

Les menus contextuels proposés dans l’affichage de données varient en fonction de l’endroit où vous cliquez avec le bouton droit.

Cliquez avec le bouton droit sur une cellule de données

La capture d’écran suivante montre le menu de contenu que vous obtenez quand vous cliquez avec le bouton droit dans une cellule de l’affichage de données. La capture d’écran montre également le menu Copier développé.

Screenshot showing right-click a cell, in the data display.

Cliquez avec le bouton droit sur un en-tête de colonne

La capture d’écran suivante montre le menu contextuel qui s’affiche après un clic droit dans l’en-tête timestamp .

Screenshot showing right-click a column header, in the data display, or details grid.

Choisir des colonnes, fusionner des colonnes

L’option Choisir des colonnes vous permet de contrôler les colonnes de données affichées. Vous pouvez trouver l’élément de menu Choisir les colonnes à plusieurs endroits :

  • dans le menu Événements étendus ;
  • Dans la barre d’outils Événements étendus .
  • dans le menu contextuel d’un en-tête de l’affichage de données.

Lorsque vous sélectionnez Choisir des colonnes, la boîte de dialogue du même nom s’affiche.

Screenshot showing choose Columns dialog, also offers Merge columns options.

Fusionner des colonnes

La boîte de dialogue Choisir des colonnes comporte une section consacrée à la fusion de plusieurs colonnes en une, à des fins d’affichage et d’exportation de données.

Filtres

Les filtres de l’observateur d’événements SSMS peuvent :

  • Restreindre les données retournées par la colonne timestamp
  • Filtrer par valeur de colonne

La relation entre le filtre de temps et le filtre de colonnes est une valeur booléenne AND.

Screenshot of time range, and column filters, on the Filters dialog.

Groupe et agrégation

Regrouper des lignes par la mise en correspondance des valeurs d’une colonne donnée est la première étape de l’agrégation synthétique de données.

Regroupement

Dans la barre d’outils Événements étendus , le bouton Regroupement démarre une boîte de dialogue que vous pouvez utiliser pour regrouper les données affichées par une colonne donnée. La capture d’écran suivante montre une boîte de dialogue qui permet d’effectuer un regroupement en fonction de la colonne nom.

Screenshot showing the toolbar with Grouping selected and the Grouping dialog box.

Une fois le regroupement terminé, l’affichage a une nouvelle apparence, comme indiqué ci-dessous.

Screenshot of new display look after Grouping.

Agrégation

Une fois que les données affichées ont été regroupées, vous pouvez poursuivre en agrégeant les données dans d’autres colonnes. La capture d’écran suivante illustre l’agrégation des données regroupées par nombre ( count).

Screenshot showing the toolbar with Aggregation selected and the Aggregation dialog box.

Une fois l’agrégation terminée, l’affichage a une nouvelle apparence, comme indiqué ci-dessous.

Screenshot of the display showing that a COUNT value has been added.

Afficher le plan de requête d’exécution

L’événement query_post_execution_showplan vous permet de voir le plan de requête réel (avec les statistiques d’exécution incluses) dans l’interface utilisateur de SSMS. Lorsque le volet Détails est visible, vous pouvez voir le plan de requête graphique sous l’onglet Plan de requête. En pointant sur un nœud sur le plan de requête, vous pouvez voir une liste de noms de propriétés et leurs valeurs pour le nœud de plan.

Screenshot of Query Plan, with properties list for one node.

Contenu associé