Регистрация событий в пакете служб Integration Services

  • Статья

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

Пакет служб Службы Integration Services записывает различные сообщения о событиях в журнал событий приложений Windows. Пакет записывает эти сообщения при запуске пакета при остановке пакета и возникновении определенных неполадок.

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

Общие сведения о способах выполнения пакетов служб SSIS см. в разделе Запуск проектов и пакетов.

Сведения о диагностике выполняющихся пакетов см. в разделе Устранение неполадок инструментов с помощью отчетов.

Сообщения о состоянии пакета

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

Примечание

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

Идентификатор события Символическое имя текст Примечания
12288 DTS_MSG_PACKAGESTART Пакет "" запущен. Выполнение пакета началось.
12289 DTS_MSG_PACKAGESUCCESS Выполнение пакета «» завершилось успешно. Пакет успешно выполнен и более не выполняется.
12290 DTS_MSG_PACKAGECANCEL Пакет "%1!s!!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. Откройте текстовый редактор, вставьте и сохраните запись журнала в текстовом файле.