sys.fn_trace_getfilterinfo (Transact-SQL)
Returns information about the filters applied to a specified trace.
Important
This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use Extended Events instead.
.gif "Topic link icon")
Transact-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 sys.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
See Also
Tasks
Reference
sp_trace_setfilter (Transact-SQL)
sp_trace_create (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setstatus (Transact-SQL)
sys.fn_trace_geteventinfo (Transact-SQL)