sp_help_jobschedule (Transact-SQL)

Статья
06/18/2013

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

Значок ссылки на раздел Соглашение о синтаксисе в Transact-SQL

Синтаксис

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 обновляется каждые двадцать минут. Это может повлиять на значения, возвращаемые этой хранимой процедурой.

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

Замечания

Параметры хранимой процедуры 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)

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