Регистрация событий в пакете служб Integration Services
Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure
Пакет служб Integration Services регистрирует различные сообщения о событиях в журнал событий приложения Windows. Пакет записывает эти сообщения при запуске пакета при остановке пакета и возникновении определенных неполадок.
В этом разделе содержатся сведения о часто встречающихся сообщениях о событиях, записываемых пакетом в журнал событий приложений. По умолчанию пакет записывает некоторые из этих сообщений, даже если режим записи в журнал для пакета не включен. Однако существуют другие сообщения, которые пакет записывает, только если для пакета включен режим записи в журнал. Независимо от того, записывает ли пакет эти сообщения в журнал по умолчанию или потому что запись была разрешена, источником событий для сообщений в пакете является SQLISPackage.
Общие сведения о способах выполнения пакетов служб SSIS см. в разделе Запуск проектов и пакетов.
Сведения о диагностике выполняющихся пакетов см. в разделе Устранение неполадок инструментов с помощью отчетов.
Сообщения о состоянии пакета
При запуске пакета служб Integration Services пакет обычно регистрирует различные сообщения о ходе выполнения и состоянии пакета. Эти сообщения перечислены в следующей таблице.
Примечание.
Пакет будет записывать сообщения, перечисленные в следующей таблице, даже если режим записи в журнал для пакета не включен.
ИД события | Символическое имя | Текст | Примечания. |
---|---|---|---|
12288 | DTS_MSG_PACKAGESTART | Пакет "" запущен. | Выполнение пакета началось. |
12289 | DTS_MSG_PACKAGESUCCESS | Выполнение пакета «» завершилось успешно. | Пакет успешно выполнен и более не выполняется. |
12290 | DTS_MSG_PACKAGECANCEL | Пакет "%1!s!" отменен. | Пакет более не выполняется, так как пакет был отменен. |
12291 | DTS_MSG_PACKAGEFAILURE | Ошибка выполнения пакета «». | Пакет не удалось выполнить успешно, и его выполнение остановлено. |
По умолчанию в новой установке службы Integration Services настроены не для регистрации определенных событий, связанных с выполнением пакетов в журнал событий приложения. Этот параметр предотвращает слишком много записей журнала событий при использовании функции сборщика данных текущего выпуска СЛУЖБ SQL Server Integration Services. События, которые не регистрируются в журнале: EventID 12288 "Пакет запущен" и EventID 12289 "Пакет успешно завершен". Чтобы включить регистрацию этих событий в журнале, откройте реестр в режиме редактирования. Затем найдите в реестре узел HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\110\SSIS и измените значение DWORD для параметра LogPackageExecutionToEventLog с 0 на 1. Однако в процессе обновления службы Integration Services настроены для регистрации этих двух событий. Чтобы отключить запись в журнал, измените значение параметра LogPackageExecutionToEventLog с 1 на 0.
Сообщения, связанные с регистрацией пакетов
Если вы включили ведение журнала в пакете, журнал событий приложения является одним из назначений, поддерживаемых дополнительными функциями ведения журнала в пакетах служб Integration Services. Дополнительные сведения см. в статье Ведение журналов в службах Integration Services (SSIS).
Если для пакета включена запись в журнал и местом назначения является журнал событий приложений, то пакет вносит записи, относящиеся к следующим сведениям.
Сообщения о стадии во время выполнения пакета.
Сообщения об определенных событиях, происходящих при выполнении пакета.
Сообщения о стадиях выполнения пакета
ИД события | Символическое имя | Текст | Примечания. |
---|---|---|---|
12544 | DTS_MSG_EVENTLOGENTRY | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | При настройке записи пакета в журнал событий приложений Windows различные сообщения используют данный общий формат. |
12556 | DTS_MSG_EVENTLOGENTRY_PACKAGESTART | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Пакет запущен. |
12547 | DTS_MSG_EVENTLOGENTRY_PREVALIDATE | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Проверка объекта готова начаться. |
12548 | DTS_MSG_EVENTLOGENTRY_POSTVALIDATE | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Проверка объекта выполнена. |
12552 | DTS_MSG_EVENTLOGENTRY_PROGRESS | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Это типовое сообщение сообщает о ходе выполнения пакета. |
12546 | DTS_MSG_EVENTLOGENTRY_POSTEXECUTE | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Объект завершил работу. |
12557 | DTS_MSG_EVENTLOGENTRY_PACKAGEEND | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Пакет завершил выполнение. |
Сообщение о произошедших событиях
В следующей таблице перечислены только некоторые сообщения, которые стали результатом событий. Более полный список ошибок, предупреждений и информационных сообщений, которые используют службы Integration Services, см. в справочнике по ошибкам и сообщениям служб Integration Services.
ИД события | Символическое имя | Текст | Примечания. |
---|---|---|---|
12251 | DTS_MSG_EVENTLOGENTRY_TASKFAILED | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Ошибка при выполнении задачи. |
12250 | DTS_MSG_EVENTLOGENTRY_ERROR | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Это сообщение о произошедшей ошибке. |
12249 | DTS_MSG_EVENTLOGENTRY_WARNING | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Это сообщение о произошедшем предупреждении. |
12258 | DTS_MSG_EVENTLOGENTRY_INFORMATION | Имя события: %1%r Сообщение: %9%r Оператор: %2%r Имя источника: %3%r Идентификатор источника: %4%r Идентификатор выполнения: %5%r Время начала: %6%r Время окончания: %7%r Код данных: %8 | Это сообщение выдает сведения, не связанные с ошибкой или предупреждением. |
Просмотр записей журнала в окне "Регистрация событий"
Эта процедура описывает, как выполнить пакет и просмотреть записи журнала, которые он записывает. Записи журнала можно просмотреть в реальном времени. Записи журнала, которые записываются в окно Регистрация событий , также можно копировать и сохранять для будущего анализа.
При отсутствии необходимости записи в журнал запись введется в окно Регистрация событий .
Просмотр записей журнала
В SQL Server Data Tools откройте проект служб Integration Services, содержащий нужный пакет.
В меню Службы SSIS выберите пункт Регистрация событий. При необходимости можно вывести окно Регистрация событий , сопоставив команду View.LogEvents комбинации клавиш по своему выбору на странице Клавиатура диалогового окна Параметры .
В меню Отладка выберите пункт Начать отладку.
По мере того, как среда выполнения определяет события и пользовательские сообщения, для которых разрешена запись в журнал, записи журнала для таких событий и сообщений записываются в окно Регистрация событий .
В меню Отладка выберите пункт Остановить отладку.
Записи журнала остаются доступными в окне "События журнала", пока не перезапустите пакет, запустите другой пакет или закройте SQL Server Data Tools.
Просмотрите записи журнала в окне Регистрация событий .
По желанию выберите запись журнала для копирования. Щелкнув правой кнопки мыши, откройте контекстное меню и выберите пункт Копировать.
По желанию дважды щелкните запись журнала и в диалоговом окне Запись журнала просмотрите детали по выбранной записи.
В диалоговом окне Запись журнала щелкните стрелки вверх и вниз, чтобы отображать предыдущую и следующую записи журнала или щелкните значок копирования для копирования записи журнала.
Откройте текстовый редактор, вставьте и сохраните запись журнала в текстовом файле.