| title | Replay to a Cursor | |
|---|---|---|
| titleSuffix | SQL Server Profiler | |
| description | Discover how to use a cursor in SQL Server Profiler to pause a trace replay at a specific point. Make debugging easier by replaying to a cursor. | |
| author | rwestMSFT | |
| ms.author | randolphwest | |
| ms.date | 06/05/2025 | |
| ms.service | sql | |
| ms.subservice | profiler | |
| ms.topic | how-to | |
| ms.collection |
|
[!INCLUDE SQL Server Azure SQL Managed Instance]
This article describes how to replay trace files or tables that pause when a cursor is reached by using [!INCLUDE ssSqlProfiler]. Pausing traces at cursors supports debugging because you can break the replay of long trace scripts into short segments that can be analyzed incrementally.
-
Open the trace file or trace table you want to replay. For more information, see Open a trace file (SQL Server Profiler) or Open a trace table (SQL Server Profiler).
Make sure that the trace file or table you open contains the event classes necessary for replay. For more information, see Replay Requirements.
-
In the trace window, select an event.
-
On the Replay menu, select Run to Cursor, and then connect to the server where you want to replay the trace.
-
In the Replay Configuration dialog box, verify the settings, and then select OK.
The replay starts, pausing when the first cursor is reached.
-
Press F5 to resume the trace.
-
Repeat Step 5 through the end of the trace.