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

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

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

• Конструктор SSIS предоставляет отчеты о ходе выполнения в процессе выполнения.

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

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

Конструктор служб SSIS предоставляет диалоговое окно "Установка точек останова ", в котором можно задать точки останова, включив условия останова и указав время, когда точка останова может возникнуть до приостановки выполнения пакета. Точки останова можно включить на уровне пакета или на уровне отдельного компонента. Если условия останова включены на уровне задачи или контейнера, значок точки останова отображается рядом с задачей или контейнером на вкладке "Поток управления ". Если условия останова включены в пакете, на вкладке "Поток управления " появится значок точки останова.

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

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

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

Помимо условий останова, доступных всем задачам и контейнерам, некоторые задачи и контейнеры включают специальные условия останова для настройки точек останова. Например, можно включить условие останова в контейнере "Цикл", который задает точку останова, которая приостанавливает выполнение в начале каждого итерации цикла.

Чтобы добавить гибкость и мощность в точку останова, можно изменить поведение точки останова, указав следующие параметры:

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

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

Типы счетчиков попаданий, за исключением типа Always, дополнительно квалифицированы счетчиком попаданий. Например, если тип равен "Число попаданий равен", а число попаданий равно 5, выполнение приостанавливается на шестом вхождении в условие разрыва.

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

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

Установить точки останова

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

Отчеты о ходе выполнения

Конструктор служб SSIS включает два типа отчетов о ходе выполнения: цветовую кодировку на вкладке "Поток управления " и сообщения о ходе выполнения на вкладке "Ход выполнения ".

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

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

Цвет	Состояние выполнения
Серый	Ожидание запуска
Жёлтый	Бег
Зеленый	Успешно выполнено
Выделены	Выполнение с ошибками

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

Замечание

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

На следующей схеме показана вкладка "Ход выполнения ".

Отладка Windows

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

Чтобы открыть эти окна в SQL Server Data Tools (SSDT), щелкните меню отладки , наведите указатель на Windows и выберите пункт "Точки останова", " Вывод" или "Интерпретация".

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

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

См. также

Инструменты для устранения неполадок при разработке пакетов