sp_help_jobs_in_schedule (Transact-SQL)

Статья
11/07/2023

Применимо к:SQL Server

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

Синтаксис

  
sp_help_jobs_in_schedule   
     [ @schedule_name = ] 'schedule_name' ,  
     [ @schedule_id = ] schedule_id

Аргументы

[ @schedule_id = ] schedule_id Идентификатор расписания для перечисления сведений. schedule_id не используется без значения по умолчанию. Можно указать 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	Показывает, разрешено ли задание к выполнению.
описание	nvarchar(512)	Описание задания.
start_step_id	int	Идентификатор шага задания, с которого должно начаться выполнение.
category	sysname	Категория задания.
владелец	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)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)