sp_help_jobs_in_schedule (Transact-SQL)
Возвращает сведения о заданиях, присоединенных к определенному расписанию.
Синтаксис
sp_help_jobs_in_schedule
[ @schedule_name = ] 'schedule_name' ,
[ @schedule_id = ] schedule_id
Аргументы
[ @schedule_id = ] schedule_id
Идентификатор расписания для занесения в список сведений. Аргумент schedule_id имеет тип int и не имеет значения по умолчанию. Можно указать либо аргумент schedule_id, либо schedule_name.[ @schedule_name = ] 'schedule_name'
Имя расписания для занесения в список сведений. Аргумент schedule_name имеет тип sysname и не имеет значения по умолчанию. Можно указать либо аргумент schedule_id, либо schedule_name.
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Результирующие наборы
Возвращает следующий результирующий набор.
Имя столбца |
Тип данных |
Описание |
---|---|---|
job_id |
uniqueidentifier |
Уникальный идентификатор задания. |
originating_server |
nvarchar(30) |
Имя сервера, от которого поступило задание. |
name |
sysname |
Имя задания. |
enabled |
tinyint |
Показывает, разрешено ли задание для выполнения. |
description |
nvarchar(512) |
Описание задания. |
start_step_id |
int |
Идентификатор шага задания, с которого должно начаться выполнение. |
category |
sysname |
Категория заданий. |
owner |
sysname |
Владелец задания. |
notify_level_eventlog |
int |
Битовая маска, указывающая, при каких обстоятельствах событие уведомления должно записываться в журнал приложений Microsoft Windows. Может иметь одно из следующих значений: 0 = никогда; 1 = при успешном завершении задания; 2 = при сбое в выполнении задания; 3 = каждый раз по завершении задания (вне зависимости от результата выполнения). |
notify_level_email |
int |
Битовая маска, показывающая, при каких обстоятельствах должно посылаться уведомление по электронной почте при завершении выполнения задания. Допустимые значения такие же, как для параметра notify_level_eventlog. |
notify_level_netsend |
int |
Битовая маска, показывающая, при каких обстоятельствах должно посылаться сообщение по сети при завершении выполнения задания. Допустимые значения такие же, как для параметра notify_level_eventlog. |
notify_level_page |
int |
Битовая маска, показывающая, при каких обстоятельствах должно посылаться сообщение на пейджер при завершении выполнения задания. Допустимые значения такие же, как для параметра notify_level_eventlog. |
notify_email_operator |
sysname |
Имя адреса электронной почты уведомляемого оператора. |
notify_netsend_operator |
sysname |
Имя компьютера или пользователя, используемое при отправке сетевых сообщений. |
notify_page_operator |
sysname |
Имя компьютера или пользователя, используемое при отправке сообщения на пейджер. |
delete_level |
int |
Битовая маска, показывающая, при каких обстоятельствах задание должно удаляться при завершении выполнения задания. Допустимые значения такие же, как для параметра notify_level_eventlog. |
date_created |
datetime |
Дата создания задания. |
date_modified |
datetime |
Дата последнего изменения задания. |
version_number |
int |
Версия задания (автоматически обновляется при каждом изменении задания). |
last_run_date |
int |
Дата последнего запуска задания. |
last_run_time |
int |
Время последнего запуска задания. |
last_run_outcome |
int |
Результат последнего выполнения задания: 0 = сбой; 1 = выполнено; 3 = отменено; 5 = неизвестно. |
next_run_date |
int |
Дата следующего выполнения задания по расписанию. |
next_run_time |
int |
Время следующего выполнения задания по расписанию. |
next_run_schedule_id |
int |
Идентификационный номер следующего выполнения по расписанию. |
current_execution_status |
int |
Состояние текущего выполнения. |
current_execution_step |
sysname |
Текущий шаг выполнения задания. |
current_retry_attempt |
int |
Если задание выполняется и этап был повторен — это текущая попытка повтора. |
has_step |
int |
Число шагов в задании. |
has_schedule |
int |
Число запланированных выполнений задания. |
has_target |
int |
Число целевых серверов задания. |
type |
int |
Тип задания: 1 = локальное задание; 2 = многосерверное задание; 0 = задание не имеет целевых серверов. |
Замечания
Эта процедура заносит в список сведения о заданиях, присоединенных к указанному расписанию.
Разрешения
По умолчанию эту хранимую процедуру могут выполнять члены предопределенной роли сервера sysadmin. Другим пользователям должна быть предоставлена одна из следующих предопределенных ролей базы данных агента SQL Server в базе данных msdb:
SQLAgentUserRole;
SQLAgentReaderRole;
SQLAgentOperatorRole.
Подробные сведения о разрешениях для этих ролей см. в разделе Предопределенные роли базы данных агента SQL Server.
Члены роли SQLAgentUserRole могут просматривать состояние только тех заданий, которыми они владеют.
Примеры
В следующем примере в список заносятся задания, присоединенные к расписанию NightlyJobs.
USE msdb ;
GO
EXEC sp_help_jobs_in_schedule
@schedule_name = N'NightlyJobs' ;
GO