sp_help_jobhistory (Transact-SQL)

Область применения: SQL Server

Предоставляет сведения о заданиях серверов в многосерверном административном домене.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_help_jobhistory
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @sql_message_id = ] sql_message_id ]
    [ , [ @sql_severity = ] sql_severity ]
    [ , [ @start_run_date = ] start_run_date ]
    [ , [ @end_run_date = ] end_run_date ]
    [ , [ @start_run_time = ] start_run_time ]
    [ , [ @end_run_time = ] end_run_time ]
    [ , [ @minimum_run_duration = ] minimum_run_duration ]
    [ , [ @run_status = ] run_status ]
    [ , [ @minimum_retries = ] minimum_retries ]
    [ , [ @oldest_first = ] oldest_first ]
    [ , [ @server = ] N'server' ]
    [ , [ @mode = ] 'mode' ]
[ ; ]

Аргументы

[ @job_id = ] 'job_id'

Идентификационный номер задания. @job_id является уникальным идентификатором по умолчаниюNULL.

[ @job_name = ] N'job_name'

Имя задания. @job_name — sysname с значением по умолчаниюNULL.

[ @step_id = ] step_id

Идентификационный номер этапа. @step_id имеет значение int с значением по умолчаниюNULL.

[ @sql_message_id = ] sql_message_id

Идентификационный номер сообщения об ошибке, возвращаемого SQL Server при выполнении задания. @sql_message_id имеет значение int с значением по умолчаниюNULL.

[ @sql_severity = ] sql_severity

Уровень серьезности сообщения об ошибке, возвращаемого SQL Server при запуске задания. @sql_severity имеет значение int с значением по умолчаниюNULL.

[ @start_run_date = ] start_run_date

Дата запуска задания. @start_run_date имеет значение int с значением по умолчаниюNULL. @start_run_date необходимо ввести в форме, где yyyy имеется четырехзначный yyyyMMddгод, MM является двухзначным именем месяца и dd является двухзначным именем дня.

[ @end_run_date = ] end_run_date

Дата завершения задания. @end_run_date имеет значение int с значением по умолчаниюNULL. @end_run_date необходимо ввести в форме yyyyMMdd, где yyyy имеется четырехзначный год, MM является двухзначным именем месяца и dd является двухзначным именем дня.

[ @start_run_time = ] start_run_time

Время запуска задания. @start_run_time имеет значение int с значением по умолчаниюNULL. @start_run_time необходимо ввести в форме HHmmss, где HH двухзначный час дня, mm является двухзначной минутой дня и ss является двухзначной секундой дня.

[ @end_run_time = ] end_run_time

Время завершения выполнения задания. @end_run_time имеет значение int с значением по умолчаниюNULL. @end_run_time необходимо ввести в формеHHmmss, где HH является двухзначный час дня, mm является двухзначной минутой дня и ss является двухзначной секундой дня.

[ @minimum_run_duration = ] minimum_run_duration

Минимальное время для выполнения задания. @minimum_run_duration имеет значение int с значением по умолчаниюNULL. @minimum_run_duration необходимо ввести в формеHHmmss, где HH является двухзначный час дня, mm является двухзначной минутой дня и ss является двухзначной секундой дня.

[ @run_status = ] run_status

Состояние выполнения задания.@run_status является int и может быть одним из этих значений.

[ @minimum_retries = ] minimum_retries

Минимальное число повторных попыток выполнить задание. @minimum_retries имеет значение int с значением по умолчаниюNULL.

[ @oldest_first = ] oldest_first

Следует ли сначала представить выходные данные с самыми старыми заданиями. @oldest_first имеет значение int с значением по умолчанию0.

• 0 сначала представляет самые новые задания.
• 1 сначала представляет самые старые задания.

[ @server = ] N'server'

Имя сервера, на котором было выполнено задание. @server имеет имя sysname с значением по умолчаниюNULL.

[ @mode = ] 'mode'

Указывает, выводит ли SQL Server все столбцы в результирующем наборе (FULL) или сводку (SUMMARY) столбцов. @mode — varchar(7) с значением по умолчаниюSUMMARY.

Значения кода возврата

0 (успешно) или 1 (сбой).

Результирующий набор

Фактический список столбцов зависит от значения @mode. Самый полный набор столбцов показан в следующей таблице и возвращается при @modeFULL.

Замечания

sp_help_jobhistory возвращает отчет с историей указанных запланированных заданий. Если не указаны параметры, отчет содержит журнал всех заданий в расписании.

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.

Другим пользователям необходимо предоставить одну из следующих агент SQL Server предопределенных ролей базы данных в msdb базе данных:

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

Дополнительные сведения о разрешениях этих ролей см. в разделе Предопределенные роли базы данных агента SQL Server.

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

Примеры

А. Вывод списка всех сведений о задании

В следующем примере отображаются все сведения о задании NightlyBackups.

USE msdb;
GO

EXEC dbo.sp_help_jobhistory
    @job_name = N'NightlyBackups';
GO

B. Вывод сведений о заданиях, которые соответствуют определенным условиям

Следующий пример иллюстрирует вывод всех сведений о шагах заданий, завершившихся неудачно с кодом ошибки 50100 (пользовательская ошибка) и уровнем серьезности 20.

USE msdb;
GO

EXEC dbo.sp_help_jobhistory
    @sql_message_id = 50100,
    @sql_severity = 20,
    @run_status = 0,
    @mode = N'FULL';
GO

Связанный контент

• sp_purge_jobhistory (Transact-SQL)
• Системные хранимые процедуры (Transact-SQL)