Отладчик Transact-SQLTransact-SQL debugger

Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions) Применимо к:Applies to: даSQL ServerSQL Server (все поддерживаемые версии) yesSQL ServerSQL Server (all supported versions)

Отладчик Transact-SQLTransact-SQL позволяет находить ошибки в коде Transact-SQLTransact-SQL путем проверки поведения кода во время его выполнения.The Transact-SQLTransact-SQL debugger helps you find errors in Transact-SQLTransact-SQL code by investigating the run-time behavior of the code. После перевода окна редактора запросов компонента Компонент Database EngineDatabase Engine в режим отладки можно приостанавливать выполнение на определенных строках кода и просматривать сведения и данные, которые используются или возвращаются соответствующими инструкциями Transact-SQLTransact-SQL .After you set the Компонент Database EngineDatabase Engine Query Editor window to debug mode, you can pause execution on specific lines of code and inspect information and data that is used by or returned by those Transact-SQLTransact-SQL statements.

Эта функция работает с SSMS версии 17.9.1 и предшествующими версиями.This feature works with SSMS version 17.9.1 and earlier.

Пошаговая отладка кода Transact-SQLStepping through Transact-SQL Code

Если окно редактора компонента Transact-SQLTransact-SQL находится в режиме отладки, отладчик Transact-SQLTransact-SQL предоставляет следующие возможности для перемещения по коду Компонент Database EngineDatabase Engine .The Transact-SQLTransact-SQL debugger provides the following options that you can use to navigate through Transact-SQLTransact-SQL code when the Компонент Database EngineDatabase Engine Query Editor window is in debug mode:

  • Установка точек останова на отдельных инструкциях Transact-SQLTransact-SQL .Set breakpoints on individual Transact-SQLTransact-SQL statements.

    Точка останова указывает точку, в которой необходимо приостановить выполнение, чтобы просмотреть данные.A breakpoint specifies a point at which you want execution to pause so you can examine data. При запуске отладчика он останавливается на первой строке кода в окне редактора запросов.When you start the debugger, it pauses on the first line of code in the Query Editor window. Чтобы выполнить код до первой установленной точки останова, используйте функцию Продолжить .To run to the first breakpoint that you have set, you can use the Continue feature. Функцию Продолжить также можно использовать для выполнения кода до следующей точки останова от любого места, в котором выполнение было приостановлено.You can also use the Continue feature to run to the next breakpoint from any location at which the window is currently paused. Точки останова можно изменить и указать действия или условия, при которых точка останова должна остановить выполнение, вывести информацию в окно Вывод и изменить расположение точки останова.You can edit breakpoints to specify actions such as the conditions under which the breakpoint should pause execution, information to print to the output window, and change the location of the breakpoint.

  • Перейти в следующую инструкцию.Step into the next statement.

    Эта функция позволяет выполнять набор инструкций по одной, наблюдая при этом за их поведением.This option enables you to navigate through a set of statements one by one, and to observe their behavior as you go.

  • Переход в вызов хранимой процедуры или функции либо через него.Step either into or over a call to a stored procedure or function.

    Если есть уверенность, что в хранимой процедуре ошибок нет, то ее можно пропустить.If you're sure there are no errors in a stored procedure, you can step over it. Процедура полностью выполняется, а результаты возвращаются коду.The procedure is executed in full, and the results are returned to the code.

    Если требуется отладить хранимую процедуру или функцию, можно выполнить шаг с заходом в модуль.If you want to debug a stored procedure or function, you can step into the module. SQL Server Management StudioSQL Server Management Studio откроет новое окно редактора запросов компонента Компонент Database EngineDatabase Engine с исходным кодом этого модуля, переведет это окно в режим отладки, а затем приостановит выполнение на первой инструкции модуля.opens a new Компонент Database EngineDatabase Engine Query Editor window that is populated with the source code for the module, places the window into debug mode, and then pauses execution on the first statement in the module. Затем по коду модуля можно будет переходить, например, установив точки останова или выполняя код пошагово.You can then navigate through the module code, for example, by setting breakpoints or stepping through the code.

Дополнительные сведения о том, как отладчик позволяет переходить по коду, см. в разделе Пошаговая отладка кода Transact-SQL.For more information about how the debugger enables you to navigate code, see Step Through Transact-SQL Code.

Просмотр сведений отладчикаViewing debugger information

Каждый раз, когда отладчик приостанавливает выполнение на определенной инструкции Transact-SQLTransact-SQL , с текущим состоянием выполнения можно ознакомиться при помощи следующих окон отладчика.Each time the debugger pauses execution on a specific Transact-SQLTransact-SQL statement, you can use the following debugger windows to view the current execution state:

  • Локальные значения и Просмотр значенийLocals and Watch. В этих окнах отображаются выделенные в данный момент выражения Transact-SQLTransact-SQL .These windows display currently allocated Transact-SQLTransact-SQL expressions. Выражения — это предложения Transact-SQLTransact-SQL , значением которых является отдельное скалярное выражение.Expressions are Transact-SQLTransact-SQL clauses that evaluate to a single, scalar expression. Отладчик Transact-SQLTransact-SQL поддерживает просмотр выражений, которые ссылаются на переменные, параметры или встроенные функции Transact-SQLTransact-SQL, имена которых начинаются с @@.The Transact-SQLTransact-SQL debugger supports viewing expressions that reference Transact-SQLTransact-SQL variables, parameters, or the built-in functions that have names that start with @@. В этих окнах также отображаются значения данных, которые назначены выражениям на текущий момент.These windows also display the data values that are currently assigned to the expressions.

  • Быстрая проверка.QuickWatch. Это окно отображает значение выражения Transact-SQLTransact-SQL и позволяет сохранять это выражение в окне Просмотр значений .This window displays the value of a Transact-SQLTransact-SQL expression, and enables saving that expression to a Watch window.

  • Точки останова.Breakpoints. Это окно отображает установленные точки останова и позволяет управлять ими.This window displays the currently set breakpoints and enables you to manage them.

  • Стек вызова.Call Stack. В этом окне отображается текущее положение выполнения.This window displays the current execution location. В нем также представлены сведения о том, как выполнение прошло от исходного окна редактора запросов через все функции, хранимые процедуры или триггеры до текущего положения выполнения.And also provides information about how execution passed from the original Query Editor window through any functions, stored procedures, or triggers to reach the current execution location.

  • Вывод.Output. В этом окне отображаются различные сообщения и программные данные, например системные сообщения от отладчика.This window displays various messages and program data, such as system messages from the debugger.

  • Результаты и СообщенияResults and Messages. На этих вкладках окна редактора запросов отображаются результаты ранее выполненных инструкций Transact-SQLTransact-SQL .These tabs on the Query Editor window display the results of previously executed Transact-SQLTransact-SQL statements.

Задачи отладчика Transact-SQLTransact-SQL debugger tasks

Описание задачиTask Description РазделTopic
Описывает настройку удаленной отладки в отладчике Transact-SQLTransact-SQL .Describes how to configure the Transact-SQLTransact-SQL debugger for remote debugging. Настройка правил брандмауэра перед запуском отладчика TSQLConfigure firewall rules before running the TSQL Debugger
Описывает запуск, остановку операций отладчика и управление ими.Describes how to start, stop, and control the operation of the debugger. Запуск отладчика Transact-SQLRun the Transact-SQL Debugger
Описание использования отладчика Transact-SQLTransact-SQL для пошагового выполнения кода.Describes how to use the Transact-SQLTransact-SQL debugger to step through code. Пошаговая отладка кода Transact-SQLStep Through Transact-SQL Code
Описание использования отладчика для просмотра таких данных Transact-SQLTransact-SQL , как параметры и переменные, а также системные сведения.Describes how to use the debugger to view Transact-SQLTransact-SQL data, such as parameters and variables, and system information. Сведения отладчика Transact-SQLTransact-SQL Debugger Information

См. также разделSee also

Редакторы запросов и текста (SQL Server Management Studio)Query and Text Editors (SQL Server Management Studio)