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


sp_help_jobschedule (Transact-SQL)

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