xp_trace_setdbidfilter (T-SQL)

Specifies the database identification number (ID) filter, or the database to include for the events specified. Microsoft® SQL Server™ captures the required information, configured by executing xp_trace_seteventclassrequired, for the specified DBID.

Syntax

xp_trace_setdbidfilter {queue_handle, database_ID}

Arguments

queue_handle

Is an integer representing 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.

database_ID

Is an integer specifying for which database ID to trace events. Execute sp_helpdb to determine possible database ID values for this filter.

Return Code Values

0 (success) or >1 (failure)

Result Sets

xp_trace_setdbidfilter returns this message:

The command(s) completed successfully.

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) will be traced.

Permissions

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

Examples

This example sets the database ID for the trace queue that was configured to include a database with a DBID of 17.

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_setdbidfilter @queue_handle,

    17

See Also