Specify a Breakpoint Filter

Applies to: SQL Server

A breakpoint filter limits the breakpoint to acting only on specified computers, operating system processes, and threads. Breakpoint filters are typically used when debugging parallel applications.

This feature works with SSMS version 17.9.1 and earlier.

Filter Considerations

Breakpoint filters are not typically used with the Transact-SQL debugger because Transact-SQL scripts and stored procedures are not parallel applications.

To Specify a Breakpoint Filter

  1. In the editor window, right-click the breakpoint glyph, and then click Filter on the shortcut menu.

    -or-

    In the Breakpoints window, right-click the breakpoint glyph, and then click Filter on the shortcut menu.

  2. In the Breakpoint Filters dialog box, use the Filter box to specify computers by name, or operating system processes and threads by either name or ID number:

    • MachineName is the computer running the instance of the Database Engine.

    • ProcessID, and ProcessName are the operating system process running the instance of the Database Engine.

    • ThreadID and ThreadName are the operating system thread running the Transact-SQL batch, procedure, or function in the instance of the Database Engine.

  3. Click OK to implement the changes, or Cancel to exit without applying the changes.

See Also

Specify a Breakpoint Condition
Specify a Hit Count
Specify a Breakpoint Action