Поделиться через

Регистрация событий в пакете служб 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 Это сообщение выдает сведения, не связанные с ошибкой или предупреждением.

Просмотр записей журнала в окне "Регистрация событий"

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

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

Просмотр записей журнала

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

  2. В меню Службы SSIS выберите пункт Регистрация событий. При необходимости можно вывести окно Регистрация событий , сопоставив команду View.LogEvents комбинации клавиш по своему выбору на странице Клавиатура диалогового окна Параметры .

  3. В меню Отладка выберите пункт Начать отладку.

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

  4. В меню Отладка выберите пункт Остановить отладку.

    Записи журнала остаются доступными в окне "События журнала", пока не перезапустите пакет, запустите другой пакет или закройте SQL Server Data Tools.

  5. Просмотрите записи журнала в окне Регистрация событий .

  6. По желанию выберите запись журнала для копирования. Щелкнув правой кнопки мыши, откройте контекстное меню и выберите пункт Копировать.

  7. По желанию дважды щелкните запись журнала и в диалоговом окне Запись журнала просмотрите детали по выбранной записи.

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

  9. Откройте текстовый редактор, вставьте и сохраните запись журнала в текстовом файле.