sp_help_jobs_in_schedule (Transact-SQL)

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

Значок ссылки на разделСинтаксические обозначения в 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