Transact-SQL 参考

sp_help_jobschedule

返回有关作业的调度的信息,SQL Server 企业管理器使用这些作业来执行自动的活动。

语法

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

参数

[@job_id =] job_id

是作业标识号。job_id 的数据类型为 uniqueidentifier,默认值为 NULL。

[@job_name =] 'job_name'

是作业名称。job_name 的数据类型为 varchar(100),默认值为 NULL。

说明  必须指定 job_idjob_name,但不能两个都指定。

[@schedule_name =] 'schedule_name'

是作业的调度项目名称。schedule_name 的数据类型为 varchar(100),默认值为 NULL。

{[@schedule_id =] schedule_id

是作业的调度项目的标识号。schedule_id 的数据类型为 int,默认值为 NULL。

返回代码值

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_jobschedule
freq_subday_type int freq_subday_interval 的单位。有关更多信息,请参见 sp_add_jobschedule
freq_subday_interval int 在作业的每次执行之间所发生的 freq_subday_type 的周期个数。有关更多信息,请参见 sp_add_jobschedule
freq_relative_interval int 在每个月中,freq_interval 的已调度作业的发生情况。有关更多信息,请参见 sp_add_jobschedule
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) 对调度的英语描述(如果已经调度)。
next_run_date int 调度下一次引发作业运行的日期。
next_run_time int 调度下一次引发作业运行的时间。

注释

sp_help_jobschedule 的参数只能用在某些组合中。如果指定了 schedule_id,那么就不能指定 job_id,也不能指定 job_name。否则,job_idjob_name 参数就可能与 schedule_name 一同使用。

权限

执行权限默认授予 public 角色。任何可以执行该过程的用户都可以对下列内容进行创建、删除或更新操作:作业、作业步骤、作业分类、作业调度、作业服务器、任务或作业历史信息。

示例
A. 返回特定作业的作业调度

下面的示例返回名为 Archive Tables 的作业的调度信息。

USE msdb
EXEC sp_help_jobhistory @job_name = 'Archive Tables'
B. 返回调度中指定项目的作业调度

下面的示例返回名为 Archive Tables 的作业以及其调度项目 Weekly Archive 的历史记录。

USE msdb
EXEC sp_help_jobhistory @job_name = 'Archive Tables', 
   @schedule_name = 'Weekly Archive'

请参见

sp_add_jobschedule

sp_delete_jobschedule

sp_update_jobschedule

系统存储过程