Отладка потока управления

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

SQL Server Data Tools (SSDT) и Microsoft Службы Integration Services включают функции и инструменты, которые можно использовать для устранения неполадок потока управления в Службы Integration Services.

• Службы Integration Services поддерживают точки останова в контейнерах и задачах.

• Integration Services во время выполнения предоставляет отчет о ходе выполнения.

• SQL Server Data Tools (SSDT) предоставляет окна отладки.

Точки останова

Integration Services предоставляет диалоговое окно Задание точек останова , в котором можно установить точки останова по следующим критериям: выполнение определенного внутреннего условия и количество проходов по данной точке до приостановления выполнения пакета. Точки останова могут быть установлены на уровне пакета или на уровне компонента. Если условие останова установлено на уровне задачи или контейнера, то значок точки останова отображается рядом с задачей или контейнером в области конструктора на вкладке Поток управления . Если условие останова установлено на уровне пакета, то значок точки останова отображается в метке вкладки Поток управления .

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

Службы Integration Services предлагают десять условий останова, которые можно установить для всех задач и контейнеров. В диалоговом окне Задание точек останова можно установить точки останова по следующим условиям.

Условие останова	Описание
Задача или контейнер получает событие OnPreExecute .	Вызывается в момент запуска задачи. Это событие возникает непосредственно перед тем, как задача или контейнер начнет свое выполнение.
Задача или контейнер получает событие OnPostExecute .	Вызывается сразу после того, как задача завершит свою работу. Это событие возникает сразу после того, как задача или контейнер завершит свое выполнение.
Задача или контейнер получает событие OnError .	Вызывается задачей или контейнером при возникновении ошибки.
Задача или контейнер получает событие OnWarning .	Вызывается, когда задача находится в состоянии, еще не подтверждающем ошибку, но уже требующем передачи предупреждения.
Задача или контейнер получает событие OnInformation .	Вызывается, когда от задачи требуется передача сведений.
Задача или контейнер получает событие OnTaskFailed .	Вызывается сервером задач при возникновении ошибки.
Задача или контейнер получает событие OnProgress .	Вызывается для обновления информации о ходе выполнения задачи.
Задача или контейнер получает событие OnQueryCancel .	Вызывается в любой момент обработки задачи, когда необходимо отменить ее выполнение.
Задача или контейнер получает событие OnVariableValueChanged .	Вызывается средой во время выполнения служб Службы Integration Services , когда изменяется значение переменной. Чтобы вызвать данное событие, для свойства RaiseChangeEvent переменной необходимо установить значение true . ** Предупреждение. ** Переменная, связанная с этой точкой останова, должна быть определена в области контейнера. Если переменная определена в области пакета, точка останова не достигается.
Задача или контейнер получает событие OnCustomEvent .	Вызывается задачей для вызова пользовательского события, определенного для данной задачи.

В дополнение к условиям останова, доступным для всех задач и контейнеров, некоторые задачи и контейнеры имеют дополнительные условия останова для установки точек останова. Например, можно активировать условия останова в контейнере «цикл по элементам», который задает точку останова, приостанавливающую выполнение в начале каждой итерации цикла.

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

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

• Тип счетчика попаданий или правило, определяющее, когда условие останова запускает точку останова.

Типы счетчика попаданий, кроме типа Always, уточняются числом попаданий. Например, если тип — «Число попаданий» и число попаданий — 5, то выполнение будет остановлено на 6-м событии условия останова.

В следующей таблице описываются типы счетчика попаданий.

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

Задание точки останова

• Выполнение отладки пакета путем установки точек останова для задачи или контейнера

Отчет о состоянии

Integration Services Конструктор включает два типа отчетов о состоянии: выделение цветом в области конструктора на вкладке Поток управления и сообщения о состоянии на вкладке Выполнение .

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

Следующая таблица описывает цвета, используемые для отображения состояния.

Color	Состояние выполнения
Серый	Ожидание выполнения
Желтый	Запущен
Зеленый	Успешное завершение
выделенный текст	Завершение с ошибками

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

Примечание

Чтобы включить или отключить отображение сообщений на вкладке Выполнение , установите или снимите флажок Отчет о ходе отладки в меню Службы SSIS .

Вкладка Выполнение показана на следующей диаграмме.

Окна отладки

SQL Server Data Tools (SSDT) содержит много окон, которые можно использовать для работы с точками останова и для отладки пакетов, содержащих точки останова. Чтобы получить больше информации по каждому из окон, откройте окно и нажмите клавишу F1 для получения справки.

Для открытия этих окон в SQL Server Data Tools (SSDT), выберите меню Отладка , выберите пункт Окнаи выберите пункт Точки останова, Выводили Немедленно.

Каждое из окон описано в таблице ниже.

Окно	Описание
Точки останова	Содержит список точек останова пакета и позволяет устанавливать и удалять точки останова.
Выходные данные	Отображает сообщения о состоянии объектов SQL Server Data Tools (SSDT).
Немедленно	Используется для отладки и вычисления выражений и вывода значений переменных.

Выполнение отладки пакета путем установки точек останова для задачи или контейнера

Эта процедура описывает, как установить точки останова в пакете, задаче, контейнерах «цикл по элементам», «цикл по каждому элементу» и контейнере последовательности.

Установка точки останова в пакете, задаче или контейнере

1. В среде SQL Server Data Tools (SSDT)откройте проект служб Службы Integration Services , содержащий необходимый пакет.

2. Дважды щелкните пакет, для которого следует установить точки останова.

3. В конструкторе служб SSIS сделайте следующее.

   • Чтобы установить точки останова в объекте пакета, перейдите на вкладку Поток управления , поместите курсор где-либо на заднем плане области конструктора, щелкните правой кнопкой мыши и выберите пункт Изменить точки останова.

   • Чтобы установить точки останова в потоке управления пакета, перейдите на вкладку Поток управления , правой кнопкой мыши щелкните задачу, контейнер "цикл по элементам", "цикл по каждому элементу" или контейнер последовательности и выберите пункт Изменить точки останова.

   • Чтобы установить точки останова в обработчике события, перейдите на вкладку Обработчик события , щелкните правой кнопкой мыши задачу, контейнер "цикл по элементам", "цикл по каждому элементу" или контейнер последовательности и выберите пункт Изменить точки останова.

4. В диалоговом окне Задание точек останова <имя контейнера> выберите точки останова для включения.

5. При необходимости измените тип счетчика попаданий и значение числа попаданий для каждой точки останова.

6. Чтобы сохранить пакеты, выберите пункт Сохранить выбранные элементы в меню Файл .

Задание точек останова

Диалоговое окно Установка точек останова используется для указания событий, для которых будут включены точки останова, а также управления поведением точек останова.

Параметры

Enabled
Выберите, чтобы включить точку останова для события.

Break Condition
Позволяет просмотреть список доступных событий, для которых можно установить точки останова.

Hit Count Type
Позволяет указать условия срабатывания точки останова.

Значение	Описание
Всегда	Выполнение приостанавливается при каждом попадании в точку останова.
Число попаданий	Выполнение приостанавливается, если число попаданий в точку останова равно значению счетчика попаданий.
Число попаданий больше или равно	Выполнение приостанавливается, если число попаданий в точку останова становится равным или больше значения, заданного счетчиком попаданий.
Число попаданий кратно	Выполнение приостанавливается, если число попаданий в точку останова кратно установленному. Например, если значение этого параметра равно 5, выполнение приостанавливается на каждой пятой точке прерывания.

Число попаданий
Позволяет задать число попаданий в точку останова, необходимое для приостановки выполнения. Этот параметр недоступен, если точка останова настроена на срабатывание всегда.

См. также:

Инструменты устранения неполадок при разработке пакета
Отладка скрипта с помощью точек останова в задаче и компоненте «Скрипт»