Filtrer des événements dans une trace (SQL Server Profiler)Filter Events in a Trace (SQL Server Profiler)

S’applique à :Applies to: ouiSQL ServerSQL Server (toutes les versions prises en charge) yesSQL ServerSQL Server (all supported versions) S’applique à :Applies to: ouiSQL ServerSQL Server (toutes les versions prises en charge) yesSQL ServerSQL Server (all supported versions)

Les filtres limitent les événements recueillis dans une trace.Filters limit the events collected in a trace. Si aucun filtre n'est défini, tous les événements des classes d'événements sélectionnées sont retournés dans le résultat de trace.If a filter is not set, all events of the selected event classes are returned in the trace output. Il n'est pas obligatoire de définir un filtre pour une trace.It is not mandatory to set a filter for a trace. Toutefois, un filtre réduit la charge liée aux opérations de traçage.However, a filter minimizes the overhead that is incurred during tracing.

Pour ajouter un filtre à une définition de trace, vous devez utiliser l’onglet Sélection des événements de la boîte de dialogue Propriétés de la trace ou Propriétés du modèle de trace .You add filters to trace definitions by using the Events Selection tab of the Trace Properties or Trace Template Properties dialog box.

Pour filtrer les événements dans une traceTo filter events in a trace

  1. Dans la boîte de dialogue Propriétés de la trace ou Propriétés du modèle de trace , cliquez sur l’onglet Sélection des événements .In the Trace Properties or Trace Template Properties dialog box, click the Events Selection tab.

    L’onglet Sélection des événements contient un contrôle de grille.The Events Selection tab contains a grid control. Le contrôle de grille est une table qui contient chacune des classes d'événements traçables.The grid control is a table that contains each of the traceable event classes. La table contient une ligne par classe d'événements.The table contains one row for each event class. Les classes d'événements peuvent différer légèrement, selon le type et la version du serveur auquel vous êtes connecté.The event classes may differ slightly, depending on the type and version of server to which you are connected. Les classes d’événements sont identifiées dans la colonne Événements de la grille, et groupées par catégorie d’événement.The event classes are identified in the Events column of the grid and are grouped by event category. Les autres colonnes répertorient les colonnes de données pouvant être retournées pour chaque classe d'événements.The remaining columns list the data columns that can be returned for each event class.

  2. Cliquez sur Filtres de colonnes.Click Column Filters.

    La boîte de dialogue Modifier le filtre s’affiche.The Edit Filter dialog box appears. Cette boîte de dialogue contient une liste d’opérateurs de comparaison que vous pouvez utiliser pour filtrer les événements dans une trace.The Edit Filter dialog box contains a list of comparison operators that you can use to filter events in a trace.

  3. Pour appliquer un filtre, cliquez sur l'opérateur de comparaison et tapez une valeur.To apply a filter, click the comparison operator, and type a value to use for the filter.

  4. Cliquez sur OK.Click OK.

Considérations :Considerations:

  • Si vous définissez un filtre sur les colonnes StartTime et EndTime de l’onglet Sélection des événements, vérifiez les éléments suivants :If you set filter conditions on the StartTime and EndTime data columns of the Events Selection tab, then make sure that:

    • La date est saisie au format suivant : YYYY/MM/DD HH:mm:sec.The date you enter matches this format: YYYY/MM/DD HH:mm:sec.

      OU-OR-

    • La case Utiliser des paramètres régionaux pour afficher les valeurs de date et d’heure est cochée dans la boîte de dialogue Options générales .Use regional settings to display date and time values is checked in the General Options dialog box. Pour afficher la boîte de dialogue Options générales, dans le menu SQL Server ProfilerSQL Server Profiler Outils, cliquez sur Option.To view the General Options dialog box, on the SQL Server ProfilerSQL Server Profiler Tools menu, click Option.

      - ET --AND-

    • La date saisie se situe entre le 1er janvier 1753 et le 31 décembre 9999.The date you enter is between January 1, 1753 and December 31, 9999.

  • Si le traçage des événements est réalisé avec l’utilitaire osql ou sqlcmd , il faut toujours ajouter % aux filtres de la colonne de données TextData .If tracing events from the osql utility or from the sqlcmd utility, always append % to filters on the TextData data column.

Voir aussiSee Also

SQL Server ProfilerSQL Server Profiler