fn_trace_getfilterinfo (Transact-SQL)

Returns information about the filters applied to a specified trace.

Topic link iconTransact-SQL Syntax Conventions

Syntax

fn_trace_getfilterinfo (trace_id)

Arguments

  • trace_id
    Is the ID of the trace. trace_id is int, with no default.

Tables Returned

Returns the following information. For more information about the columns, see sp_trace_setfilter (Transact-SQL).

Column name

Data type

Description

columnid

int

The ID of the column on which the filter is applied.

logical_operator

int

Specifies whether the AND or OR operator is applied.

comparison_operator

int

Specifies the type of comparison made:

0 = Equal

1 = Not equal

2 = Greater than

3 = Less than

4 = Greater than or equal

5 = Less than or equal

6 = Like

7 = Not like

value

sql_variant

Specifies the value on which the filter is applied.

Remarks

The user sets trace_id value to identify, modify, and control the trace. When passed the ID of a specific trace, fn_trace_getfilterinfo returns information about any filter on that trace. If the specified trace does not have a filter, this function returns an empty rowset. When passed an invalid ID, this function returns an empty rowset. For similar information about traces, see fn_trace_getinfo (Transact-SQL).

Permissions

Requires ALTER TRACE permission on the server.

Examples

The following example returns information about all filters on trace number 2.

SELECT * FROM fn_trace_getfilterinfo(2) ;
GO