sp_help_jobschedule (Transact-SQL)

Возвращает сведения о расписании выполнения заданий, используемом средой SQL Server Management Studio для выполнения автоматических действий.

Синтаксис

sp_help_jobschedule { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
     [ , [ @schedule_name = ] 'schedule_name' ]
     [ , [ @schedule_id = ] schedule_id ]
     [ , [ @include_description = ] include_description ]

Аргументы

• [ @job_id= ] job_id
  Идентификационный номер задачи. Аргумент job_id имеет тип uniqueidentifier и значение по умолчанию NULL.

• [ @job_name= ] 'job_name'
  Имя задания. Аргумент job_name имеет тип sysname и значение по умолчанию NULL.

  Примечание.
  Нужно указать либо значение аргумента job_id, либо значение аргумента job_name, но не значения обоих аргументов одновременно.

• [ @schedule_name= ] 'schedule_name'
  Имя элемента расписания для задания. Аргумент schedule_name имеет тип sysname и значение по умолчанию NULL.

• [ @schedule_id= ] schedule_id
  Идентификационный номер элемента расписания для задания. Аргумент schedule_id имеет тип int и значение по умолчанию NULL.

• [ @include_description= ] include_description
  Указывает, нужно ли включать описание расписания в результирующий набор. Аргумент include_description имеет тип bit и значение по умолчанию 0. Когда значение аргумента include_description равно 0, описание расписания не включается в результирующий набор. Когда значение аргумента include_description равно 1, описание расписания включается в результирующий набор.

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

0 (успешное завершение) или 1 (неуспешное завершение).

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

Имя столбца	Тип данных	Описание
schedule_id	int	Идентификационный номер расписания.
schedule_name	sysname	Имя расписания.
enabled	int	Расписание задействовано (1) или не задействовано (0).
freq_type	int	Значение, указывающее, когда должно выполняться задание: 1 = однократно; 4 = ежедневно; 8 = еженедельно; 16 = ежемесячно; 32 = ежемесячно относительно значения, указанного в столбце freq_interval; 64 = запускать при запуске службы SQLServerAgent.
freq_interval	int	Дни, в которые выполняется задание. Значение зависит от значения в столбце freq_type. Дополнительные сведения см. в разделе sp_add_schedule (Transact-SQL).
freq_subday_type	int	Единицы для столбца freq_subday_interval. Дополнительные сведения см. в разделе sp_add_schedule (Transact-SQL).
freq_subday_interval	int	Число периодов, указанных в столбце freq_subday_type, которое должно пройти между выполнениями задания. Дополнительные сведения см. в разделе sp_add_schedule (Transact-SQL).
freq_relative_interval	int	Запланированное в расписании задание выполняется в момент, указанный в столбце freq_interval, каждый месяц. Дополнительные сведения см. в разделе sp_add_schedule (Transact-SQL).
freq_recurrence_factor	int	Число месяцев между выполнениями задания по расписанию.
active_start_date	int	Дата, когда расписание начинает действовать.
active_end_date	int	Дата, когда расписание прекращает действовать.
active_start_time	int	Время суток, когда расписание начинает действовать.
active_end_time	int	Время суток, когда расписание прекращает действовать.
date_created	datetime	Дата создания расписания.
schedule_description	nvarchar(4000)	Описание расписания на английском языке, полученное из значений в msdb.dbo.sysschedules. Когда аргумент include_description принимает значение 0, этот столбец содержит текст, указывающий, что описание не было запрошено.
next_run_date	int	Дата следующего выполнения задания по расписанию.
next_run_time	int	Время следующего выполнения задания по расписанию.
schedule_uid	uniqueidentifier	Идентификатор расписания.
job_count	int	Возвращенное количество заданий.

Примечание.
Хранимая процедура sp_help_jobschedule возвращает значения из системных таблиц dbo.sysjobschedules и dbo.sysschedules в базе данных msdb. Таблица sysjobschedules обновляется через каждые 20 минут. Это может повлиять на значения, возвращаемые этой хранимой процедурой.

Замечания

Параметры хранимой процедуры sp_help_jobschedule можно использовать только в определенных сочетаниях. Если указан аргумент schedule_id, нельзя указывать аргументы job_id и job_name. В противном случае аргументы job_id и job_name можно использовать с аргументом schedule_name.

Разрешения

По умолчанию эту хранимую процедуру могут выполнять члены фиксированной серверной роли sysadmin. Другим пользователям должна быть предоставлена одна из следующих фиксированных ролей базы данных агента SQL Server в базе данных msdb:

• SQLAgentUserRole;
• SQLAgentReaderRole;
• SQLAgentOperatorRole.

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

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

Примеры

А. Получить расписание задания для определенного задания

Следующий пример возвращает сведения о расписании для задания с именем BackupDatabase.

USE msdb ;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'BackupDatabase' ;
GO

Б. Получить расписание задания для определенного расписания

Следующий пример возвращает сведения о расписании с названием NightlyJobs и задании с названием RunReports.

USE msdb ;
GO

EXEC dbo.sp_help_jobschedule 
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs' ;
GO

В. Получить расписание задания и описание расписания для определенного расписания

Следующий пример возвращает сведения о расписании с названием NightlyJobs и задании с названием RunReports. Возвращаемый результирующий набор включает описание расписания.

USE msdb ;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs',
    @include_description = 1 ;
GO

См. также

Справочник

sp_add_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_update_schedule (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005