Поделиться через

sp_help_jobs_in_schedule (Transact-SQL)

  • Статья

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

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

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

Синтаксис

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

Аргументы

[ @schedule_id = ] schedule_id

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

Можно указать @schedule_id или @schedule_name.

[ @schedule_name = ] N'schedule_name'

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

Можно указать @schedule_id или @schedule_name.

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

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

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

Возвращает следующий результирующий набор.

Имя столбца Тип данных Description
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 = задание не имеет целевых серверов.

Замечания

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

Разрешения

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

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

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

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

Примеры

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

USE msdb;
GO

EXEC sp_help_jobs_in_schedule
    @schedule_name = N'NightlyJobs';
GO

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