Gérer les sessions d'événements dans l'Explorateur d'objetsManage Event Sessions in the Object Explorer

S’applique à :Applies to: ouiSQL ServerSQL Server (toutes les versions prises en charge) yesSQL ServerSQL Server (all supported versions) OuiAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL DatabaseS’applique à :Applies to: ouiSQL ServerSQL Server (toutes les versions prises en charge) yesSQL ServerSQL Server (all supported versions) OuiAzure SQL DatabaseAzure SQL DatabaseYesAzure SQL DatabaseAzure SQL Database

Cette rubrique décrit les actions effectuées dans l' Explorateur d'objets qui affectent les événements étendus :This topic discusses the actions you can take in Object Explorer that affect Extended Events:

  • Créer une session d'événements étendusCreate an Extended Events Session

  • Démarrer ou arrêter une session d'événements étendusStarting or Stopping an Extended Events Session

  • Exporter une session d'événements étendusExport an Extended Events Session

  • Importer un modèle de session d'événements étendusImport an Extended Events Session Template

  • Modifier une session d'événements étendusEdit an Extended Events Session

  • Supprimer une session d'événements étendusDelete an Extended Events Session

Créer une session d'événements étendusCreate an Extended Events Session

Pour plus d'informations sur la création d'une session d'événements étendus, consultez Create an Extended Events Session.For more information about creating an Extended Events session, see Create an Extended Events Session.

Démarrer ou arrêter une session d'événements étendusStarting or Stopping an Extended Events Session

Vous pouvez démarrer ou arrêter une session d'événements étendus via l' Éditeur de requête en utilisant l'instruction ALTER EVENT SESSION , ou en utilisant le nœud Événements étendus de l' Explorateur d'objets.You can start or stop an Extended Events session through the Query Editor using the ALTER EVENT SESSION statement, or by using the Extended Events node of Object Explorer.

Quand vous arrêtez une session d’événements, la session n’apparaît plus comme une session active dans la vue de gestion dynamique sys.dm_xe_sessions.When you stop an event session, the session is no longer listed as an active session in the sys.dm_xe_sessions dynamic management view (DMV). Toutefois, la définition de session reste intacte, et vous pouvez redémarrer la session.However, the session definition remains intact, and you can restart the session. Pour supprimer complètement une définition de session, vous devez supprimer la session.To completely remove a session definition, you must delete the session.

Pour démarrer ou arrêter une session d'événements étendus, vous devez disposer de l'autorisation ALTER ANY EVENT SESSION.To start or stop an Extended Events session, you must have the ALTER ANY EVENT SESSION permission.

Quand vous arrêtez une session qui utilise une cible en mémoire, telle que la cible de mémoire tampon en anneau, la cible de création de compartiments, la cible d’appariement d’événements ou la cible de compteur d’événements synchrone, toutes les informations stockées dans la mémoire tampon de la session (colonne target_data de la vue de gestion dynamique sys.dm_xe_session_targets) sont perdues.When you stop a session that uses an in-memory target, such as the ring buffer, bucketing, event pairing, or synchronous event counter targets, all the information stored in the session's buffer (the target_data column of the sys.dm_xe_session_targets DMV) will be lost. Pour accéder aux données d'un événement après avoir interrompu une session, vous devez enregistrer les données avant de mettre fin à la session ou configurer la session pour pouvoir utiliser un fichier cible.To access event data after you stop the session, you should either save the data before you stop the session, or configure the session to use the file target.

Démarrer ou arrêter une session d'événements étendus à l'aide de l'Éditeur de requêteStart or Stop an Extended Events Session Using Query Editor

Pour démarrer une session, émettez les instructions suivantes, en remplaçant session_name par le nom de la session d’événements étendus :To start a session, issue the following statements, replacing session_name with the name of the Extended Events session:

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = START  

Pour arrêter une session, émettez les instructions suivantes, en remplaçant session_name par le nom de la session d’événements étendus :To stop a session, issue the following statements, replacing session_name with the name of the Extended Events session:

ALTER EVENT SESSION [session_name]  
ON SERVER  
STATE = STOP  

Démarrer ou arrêter une session d'événements étendus dans l'Explorateur d'objetsStart or Stop an Extended Events Session in Object Explorer

Pour démarrer ou arrêter une session d'événements étendus dans l' Explorateur d'objets, développez Gestion, Événements étendus, puis les nœuds Sessions ; cliquez ensuite avec le bouton droit sur une session, puis cliquez sur Démarrer la session ou sur Arrêter la session.To start or stop an Extended Events session in Object Explorer, expand the Management, Extended Events, and then Sessions nodes and right click on a session and then click Start Session or Stop Session.

Exporter un modèle de session d'événements étendusExport an Extended Events Session Template

Vous pouvez exporter une session d'événements étendus à l'aide de l' Explorateur d'objets, puis l'enregistrer en tant que fichier modèle .xml.You can export an Extended Events session using Object Explorer, and save it as an .xml template file. Par exemple, vous pouvez exporter une session, puis appliquer le modèle à une nouvelle session d'événements à l'aide de l' Assistant Nouvelle session ou de l'interface Nouvelle session .For example, you may want to export a session and then apply the template to a new event session using the New Session Wizard or the New Session wizard.

Lorsque vous exportez une session, assurez-vous d'enregistrer le fichier modèle à un emplacement qui utilise le système de fichiers NTFS, et que vous limitez l'accès aux utilisateurs autorisés à afficher les informations.When you export a session, make sure that you save the template file to a location that uses the NTFS file system, and that you restrict access to users who are authorized to view the information.

Pour exporter une session d'événements étendus à l'aide de l' Explorateur d'objets:To export an Extended Events session in Object Explorer:

  1. Développez les nœuds Gestion, Événements étendus, puis Sessions .Expand the Management, Extended Events, and then Sessions nodes

  2. Cliquez avec le bouton droit sur la session à exporter, puis sélectionnez Exporter une session.Right-click the session that you want to export, and select Export Session.

  3. Dans la boîte de dialogue Enregistrer sous , sélectionnez un emplacement pour enregistrer le fichier, tapez le nom du fichier dans la zone Nom de fichier , puis cliquez sur Enregistrer.In the Save As dialog box, select a location to save the file, type the file name in the File name box, and then click Save.

    Si vous enregistrez le fichier à l'emplacement de modèle par défaut SQL Server Management StudioSQL Server Management Studio , le modèle s'affiche dans la liste déroulante des modèles prédéfinis lorsque vous utilisez l' Assistant Nouvelle session et la boîte de dialogue Nouvelle session .If you save the file to the default SQL Server Management StudioSQL Server Management Studio template location, the template will appear in the dropdown list of predefined templates when you use the New Session Wizard and New Session dialog.

Importer un modèle de session d'événements étendusImport an Extended Events Session Template

À l'aide de l' Explorateur d'objets, vous pouvez importer un modèle pour une session d'événements étendus.Using Object Explorer, you can import a template for an Extended Events session. Par exemple, vous pouvez souhaiter procéder ainsi pour créer une session a partir d'un modèle qui a été exporté à partir d'une autre instance de SQL ServerSQL Server.For example, you may want to do this to create a session from a template that was exported from another instance of SQL ServerSQL Server.

Pour importer une session d'événements étendus, vous devez disposer des autorisations ALTER ANY EVENT SESSION nécessaires.To import an Extended Events session, you must have the necessary ALTER ANY EVENT SESSION permissions.

Avant d'importer un fichier modèle, vérifiez que le fichier provient d'une source approuvée.Before you import a template file, make sure that the file is from a trusted source. Les fichiers modèles doivent être enregistrés dans un emplacement qui utilise le système de fichiers NTFS et où l'accès est limité aux utilisateurs qui sont autorisés à afficher les informations.Template files should be saved to a location that uses the NTFS file system and where access is restricted to users who are authorized to view the information.

Pour importer une session d'événements étendus :To import an Extended Events session:

  1. Dans l' Explorateur d'objets, développez les nœuds Gestion, puis Événements étendus .In Object Explorer, expand the Management, and then Extended Events nodes.

  2. Cliquez avec le bouton droit sur Sessions et sélectionnez Nouvelle session.Right-click Sessions and select New Session.

  3. Donnez un nom à la session.Specify a name for the session.

  4. Développez la zone déroulante Modèle .Expand the Template drop down box.

  5. Cliquez sur <File From ...>Ouvrir et recherchez la session (fichier XML) que vous souhaitez importer.Click <File From ...>Open and browse for the session (XML file) you want to import.

La session apparaît sous le nœud Sessions .The session appears under the Sessions node. Par défaut, la session n'est pas démarrée.By default, the session is not started.

Modifier une session d'événements étendusEdit an Extended Events Session

Vous pouvez modifier une session d'événements étendus dans l'Explorateur d'objets.You can edit an Extended Events session in Object Explorer.

Pour modifier une session d'événements étendus :To edit an Extended Events session:

  1. Dans l' Explorateur d'objets, développez les nœuds Gestion, Événements étendus, puis Sessions .In Object Explorer, expand the Management, Extended Events, and then Sessions nodes.

  2. Cliquez avec le bouton droit sur une session et sélectionnez Propriétés.Right-click a session and select Properties.

  3. Dans la section Sélectionner une page , sélectionnez la ou les pages que vous souhaitez modifier.In the Select a page section, select the page or pages you want to edit.

  4. Après avoir modifié la session d'événements, cliquez sur OK.After you finish revising the event session, click OK.

Générer le script d'une définition de session d'événements à l'aide de Transact-SQLTransact-SQLScript an Event Session Definition Using Transact-SQLTransact-SQL

L'Assistant Nouvelle session et la boîte de dialogue Nouvelle session comprennent une option qui génère un script Transact-SQLTransact-SQL définissant la session événements étendus.Both the New Session Wizard and the New Session dialog have a Script option that generates the Transact-SQLTransact-SQL that defines the Extended Events session.

Vous pouvez accéder à Transact-SQLTransact-SQL pour une session d'événements étendus existante en cliquant sur le nom de la session, en sélectionnant Générer un script de la session en tant que, puis sélectionnant Créer vers.You can access the Transact-SQLTransact-SQL for an existing Extended Events session by right clicking the session name, selecting Script Session as, and then selecting Create to.

Supprimer une session d'événements étendusDelete an Extended Events Session

Vous pouvez supprimer une session d'événements étendus :You can delete an Extended Events session:

  • Dans l'Éditeur de requête, à l'aide de DROP EVENT SESSION.In Query Editor using DROP EVENT SESSION.

  • Dans l' Explorateur d'objets.In Object Explorer.

Quand vous supprimez une session d’événements, toutes les informations de configuration sont supprimées, et la définition de session ne s’affiche plus dans l’affichage catalogue sys.server_event_sessions.When you delete an event session, all configuration information is removed and the session definition no longer appears in the sys.server_event_sessions catalog view.

Notes

system_health et Always On_health sont fournies avec SQL ServerSQL Server; ne les supprimez pas.system_health and Always On_health are included with SQL ServerSQL Server; do not delete them. system_health est activée par défaut (pour plus d’informations, consultez Utiliser la session system_health).system_health is enabled by default (for more information, see Use the system_health Session). Always On_health est désactivée par défaut.Always On_health is off by default. Ces sessions collectent des données qui peuvent être utiles pour le diagnostic des problèmes de performances.These sessions collect data that can be useful for diagnosing performance issues.

Pour supprimer une session d'événements étendus, vous devez disposer de l'autorisation ALTER ANY EVENT SESSION.To delete an Extended Events session, you must have the ALTER ANY EVENT SESSION permission.

Pour supprimer une session d'événements étendus dans l' Explorateur d'objets:To delete an Extended Events session in Object Explorer:

  1. Développez les nœuds Gestion, Événements étendus, puis Sessions .Expand the Management, Extended Events, and then Sessions nodes.

  2. Cliquez avec le bouton droit sur une session et sélectionnez Supprimer.Right-click a session and select Delete.

  3. Dans la boîte de dialogue Supprimer l'objet , cliquez sur OK.In the Delete Object dialog box, click OK.

  4. Après avoir modifié la session d'événements, cliquez sur OK.After you finish revising the event session, click OK.

Pour supprimer une session d’événements étendus dans l’ Éditeur de requête, émettez les instructions suivantes en remplaçant session_name par le nom de la session d’événements étendus à supprimer :To delete an Extended Events session in the Query Editor, Issue the following statements, replacing session_name with the name of the Extended Events session that you want to delete:

DROP EVENT SESSION [session_name]  
ON SERVER