sp_help_jobs_in_schedule (Transact-SQL)
Возвращает сведения о заданиях, присоединенных к определенному расписанию.
Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии). |
Синтаксические обозначения в 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 |
Идентификатор шага задания, с которого должно начаться выполнение. |
категория |
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 |
Число целевых серверов в задании. |
тип |
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
См. также
Справочник
Хранимые процедуры агента SQL Server (Transact-SQL)
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)