отладчик Transact-SQL

Применимо к:SQL Server

Отладчик Transact-SQL помогает найти ошибки в коде Transact-SQL путем изучения поведения кода во время выполнения. После установки окна редактора запросов ядра СУБД для режима отладки можно приостановить выполнение в определенных строках кода и проверить информацию и данные, используемые или возвращаемые этими операторами Transact-SQL.

Отладка T-SQL доступна в SQL Server Data Tools для Visual Studio.

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

Отладчик Transact-SQL предоставляет следующие параметры, которые можно использовать для перехода по Transact-SQL коду, когда окно редактора запросов ядра СУБД находится в режиме отладки:

• Задайте точки останова для отдельных операторов Transact-SQL.

  Точка останова указывает точку, в которой требуется приостановить выполнение, чтобы можно было проверить данные. При запуске отладчика он приостанавливается в первой строке кода в окне редактора запросов. Чтобы запуститься в первую точку останова, используйте команду "Продолжить". Вы также можете использовать Продолжить, чтобы перейти к следующей точке останова с любой точки, если окно в настоящее время приостановлено. Можно изменить точки останова, чтобы указать такие действия, как условия, при которых точка останова должна приостановить выполнение, сведения для печати в окне вывода и изменить расположение точки останова.

• Шаг в следующую инструкцию.

  Этот параметр позволяет перемещаться по набору инструкций по одной и наблюдать за их поведением.

• Выполните шаг или переключите вызов хранимой процедуры или функции.

  Если вы уверены, что в хранимой процедуре нет ошибок, можно пропустить её выполнение. Процедура выполняется полностью, и результаты возвращаются в программу.

  Если вы хотите выполнить отладку хранимой процедуры или функции, можно перейти к модулю. Откроется новое окно редактора запросов ядра СУБД, которое заполняет исходный код модуля. Окно находится в режиме отладки, и выполнение приостанавливается на первой инструкции в модуле. Затем можно перейти по коду модуля, например путем задания точек останова или пошагового перехода по коду.

Дополнительные сведения о том, как отладчик позволяет перемещаться по коду, см. в разделе Пошаговая отладка кода Transact-SQL.

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

Каждый раз, когда отладчик приостанавливает выполнение в определенной инструкции Transact-SQL, можно использовать следующие окна отладчика для просмотра текущего состояния выполнения:

• Локальные и Наблюдение. В настоящее время эти окна отображают выделенные Transact-SQL выражения. Выражения — это предложения Transact-SQL, которые оцениваются как одно скалярное выражение. Отладчик Transact-SQL поддерживает просмотр выражений, которые ссылаются на переменные и параметры Transact-SQL, или на встроенные функции, имена которых начинаются с @@. В этих окнах также отображаются значения данных, назначенные выражениям.

• QuickWatch. В этом окне отображается значение выражения Transact-SQL и позволяет сохранить это выражение в окне "Контроль ".

• Точки останова. В этом окне отображаются точки останова, заданные в данный момент, и вы можете управлять ими.

• Стек вызовов. В этом окне отображается текущее местоположение выполнения. Информация также предоставляет сведения о том, как выполнение прошло из исходного окна редактора запросов через любые функции, хранимые процедуры или триггеры, чтобы достичь текущего места выполнения.

• Выходные данные. В этом окне отображаются различные сообщения и программные данные, такие как системные сообщения от отладчика.

• Результаты и сообщения. Эти вкладки в окне редактора запросов отображают результаты ранее выполненных Transact-SQL инструкций.

Известные проблемы и ограничения

Отладчик T-SQL применим только к экземплярам SQL Server. Отладчик не поддерживает отладку Transact-SQL кода, выполняемого в Базе данных SQL Azure, Управляемом экземпляре SQL Azure или базе данных SQL в Fabric.

В определенных условиях выделение и точки останова отладчика T-SQL могут перестать синхронизироваться с фактической точкой выполнения при пошаговом выполнении скрипта SQL. Проблема может отображаться в нескольких сценариях, включая комментарий в верхней части скрипта или пустые строки после GO инструкций.

Transact-SQL задачи отладчика

Описание задачи	Article
Описывает настройку отладчика Transact-SQL для удаленной отладки.	Настройка правил брандмауэра перед запуском отладчика Transact-SQL
Описание запуска, остановки и управления операцией отладчика.	Запуск отладчика Transact-SQL
Описывает, как использовать отладчик Transact-SQL для пошагового выполнения кода.	Пошаговое выполнение кода Transact-SQL
Описывает, как использовать отладчик Transact-SQL для пошагового выполнения кода хранимой процедуры.	Отладка хранимых процедур
Описывает, как использовать отладчик для просмотра Transact-SQL данных, таких как параметры и переменные, а также системные сведения.	сведения об отладчикеTransact-SQL