Skip to content

specify-breakpoint-filter.md

Latest commit

 

History

History
48 lines (31 loc) · 2.06 KB

specify-breakpoint-filter.md

File metadata and controls

48 lines (31 loc) · 2.06 KB
title Specify a Breakpoint Filter
titleSuffix T-SQL debugger
description Learn how to implement a breakpoint filter to limit the breakpoint to acting only when debugging is on specified computers, operating system processes, and threads.
author dzsquared
ms.author drskwier
ms.reviewer randolphwest
ms.date 09/09/2025
ms.service sql
ms.subservice ssdt
ms.topic how-to

Specify a breakpoint filter

[!INCLUDE 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.

Filter considerations

Breakpoint filters aren't typically used with the [!INCLUDE tsql] debugger because [!INCLUDE tsql] scripts and stored procedures aren't parallel applications.

Specify breakpoint filter

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

    -or-

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

  2. In the Breakpoint Settings dialog box, select the Conditions options and select Filter from the dropdown list.

  3. 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 [!INCLUDE tsql] batch, procedure, or function in the instance of the Database Engine.

  4. Select Close to implement the changes.

Related content