xp_trace_getdbidfilter (T-SQL)

Retrieves the current database identification number (DBID) filter value, which is configured by executing xp_trace_setdbidfilter and associated with the specified trace queue.

Syntax

xp_trace_getdbidfilter {queue_handle}

Arguments
queue_handle
Is an integer that represents the handle for the trace queue. queue_handle is used to reference the trace queue and is placed in an output parameter by xp_trace_addnewqueue.
Return Code Values

0 (success) or >1 (failure)

Result Sets
Column name Description
EventQueue The trace queue number
DatabaseIDFilter Database ID filter for the trace queue

Remarks

If a database ID filter was set by executing xp_trace_setdbidfilter, xp_trace_getdbidfilter returns the database ID(s) for which the specified event class(es) (set with xp_trace_seteventclassrequired) will be traced.

The output shows the database identification numbers captured for the trace queue.

Permissions

Execute permissions for xp_trace_getdbidfilter default to members of the sysadmin fixed server role but can be granted to other users.

Examples

This example retrieves the database ID filter, if one exists (one may have been set by previously executing xp_trace_setdbidfilter) for the specified trace queue (@queue_handle).

USE master

DECLARE @queue_handle int, @column_value int

SET @column_value = 16|32|8192|128|512

EXEC xp_trace_addnewqueue 1000,

    5,

    95,

    90,

    @column_value,

    @queue_handle OUTPUT

EXEC xp_trace_getdbidfilter @queue_handle

  

See Also
Monitoring with SQL Server Profiler System Stored Procedures (SQL Server Profiler Extended Procedures)
xp_trace_setdbidfilter  

  


(c) 1988-98 Microsoft Corporation. All Rights Reserved.