sp_add_jobschedule (Transact-SQL) 创建作业计划

sp_add_jobschedule (Transact-SQL) 

新建日期： 2006 年 4 月 14 日

创建作业计划。

<script type="text/Javascript"> var ExpCollDivStr = ExpCollDivStr; ExpCollDivStr = ExpCollDivStr + "ctl00_LibFrame_ctl02fec08ec,"; var ExpCollImgStr = ExpCollImgStr; ExpCollImgStr = ExpCollImgStr + "ctl00_LibFrame_ctl02img,"; </script> 语法

sp_add_jobschedule [ @job_id = ] job_id, | [ @job_name = ] 'job_name', [ @name = ] 'name'
     [ , [ @enabled = ] enabled_flag ]
     [ , [ @freq_type = ] frequency_type ]
     [ , [ @freq_interval = ] frequency_interval ]
     [ , [ @freq_subday_type = ] frequency_subday_type ]
     [ , [ @freq_subday_interval = ] frequency_subday_interval ]
     [ , [ @freq_relative_interval = ] frequency_relative_interval ]
     [ , [ @freq_recurrence_factor = ] frequency_recurrence_factor ]
     [ , [ @active_start_date = ] active_start_date ]
     [ , [ @active_end_date = ] active_end_date ]
     [ , [ @active_start_time = ] active_start_time ]
     [ , [ @active_end_time = ] active_end_time ]
     [ , [ @schedule_id = ] schedule_id OUTPUT ]

<script type="text/Javascript"> var ExpCollDivStr = ExpCollDivStr; ExpCollDivStr = ExpCollDivStr + "ctl00_LibFrame_ctl04509e8b9,"; var ExpCollImgStr = ExpCollImgStr; ExpCollImgStr = ExpCollImgStr + "ctl00_LibFrame_ctl04img,"; </script> 参数

[ @job_id = ] job_id

添加计划的作业的作业标识号。job_id 的数据类型为 uniqueidentifier，无默认值。

[ @job_name = ] 'job_name'

添加计划的作业的名称。 job_name 的数据类型为 nvarchar(128)，无默认值。

注意：
必须指定 job_id 或 job_name，但不能两个都指定。

[ @name = ] 'name'

计划的名称。name 的数据类型为 nvarchar(128)，无默认值。

[ @enabled = ] enabled_flag

指示计划的当前状态。enabled_flag 的数据类型为 tinyint，默认值为 1（启用）。如果为 0，则不启用该计划。禁用该计划时，将不运行作业。

[ @freq_type = ] frequency_type

指示作业执行时间的值。frequency_type 的数据类型为 int，默认值为 0，可以是下列值之一：

值	说明
1	一次
4	每天
8	每周
16	每月
32	每月，相对于 frequency_interval.
64	在 SQL Server 代理服务启动时运行。
128	在计算机空闲时运行。

[ @freq_interval = ] frequency_interval

执行作业的日期。frequency_interval 的数据类型为 int，默认值为 0，它依赖于下表所指示的 frequency_type 值：

值	结果
1（一次）	不使用 frequency_interval。
4（每天）	每 frequency_interval 天。
8（每周）	frequency_interval 是下面的一个或多个值（用逻辑运算符 OR 组合）： 1 = 星期日 2 = 星期一 4 = 星期二 8 = 星期三 16 = 星期四 32 = 星期五 64 = 星期六
16（每月）	每月的 frequency_interval 天。
32（与“每月”选项相关）	frequency_interval 是下列值之一： 1 = 星期日 2 = 星期一 3 = 星期二 4 = 星期三 5 = 星期四 6 = 星期五 7 = 星期六 8 = 天 9 = 工作日 10 = 休息日
64（SQL Server 代理服务启动时）	不使用 frequency_interval。
128	不使用 frequency_interval。

[ @freq_subday_type = ] frequency_subday_type

指定 frequency_subday_interval 的单位。frequency_subday_type 的数据类型为 int，无默认值，可以是下列值之一：

值	说明（单位）
0x1	在指定的时间
0x4	分
0x8	时

[ @freq_subday_interval = ] frequency_subday_interval

两次执行作业之间间隔的 frequency_subday_type 周期数。frequency_subday_interval 的数据类型为 int，默认值为 0。

[ @freq_relative_interval = ] frequency_relative_interval

当 frequency_type 设置为 32（“每月”选项相关）时，该参数进一步定义 frequency_interval。

frequency_relative_interval 的数据类型为 int，无默认值，并可以是下列值之一：

值	说明（单位）
1	第一个
2	第二个
4	第三个
8	第四个
16	最后一个

frequency_relative_interval 指示间隔的出现情况。例如，如果 frequency_relative_interval 设置为 2，frequency_type 设置为 32，并且 frequency_interval 设置为 3，则计划作业将在每月的第二个星期二发生。

[ @freq_recurrence_factor = ] frequency_recurrence_factor

作 业的两次计划执行之间的间隔周数或月数。仅当 frequency_type 设置为 8、16 或 32 时，才使用 frequency_recurrence_factor。frequency_recurrence_factor 的数据类型为 int，默认值为 0。

[ @active_start_date = ] active_start_date

可以开始执行作业的日期。active_start_date 的数据类型为 int，无默认值。日期的格式为 YYYYMMDD。如果设置 active_start_date，则日期必须大于或等于 19900101。

[ @active_end_date = ] active_end_date

可以停止执行作业的日期。active_end_date 的数据类型为 int，无默认值。日期的格式为 YYYYMMDD。

[ @active_start_time = ] active_start_time

在 active_start_date 和 active_end_date 之间的任意日期开始执行作业的时间。active_start_time 的数据类型为 int，无默认值。时间格式为 HHMMSS，采用 24 小时制。

[ @active_end_time = active_end_time

在 active_start_date 和 active_end_date 之间的任意日期停止执行作业的时间。active_end_time 的数据类型为 int，无默认值。时间格式为 HHMMSS，采用 24 小时制。

[ @schedule_id = schedule_id OUTPUT

成功创建计划时分配给计划的计划标识号。schedule_id 是 int 类型的输出变量，无默认值。

<script type="text/Javascript"> var ExpCollDivStr = ExpCollDivStr; ExpCollDivStr = ExpCollDivStr + "ctl00_LibFrame_ctl055ea99e8,"; var ExpCollImgStr = ExpCollImgStr; ExpCollImgStr = ExpCollImgStr + "ctl00_LibFrame_ctl05img,"; </script> 备注

作业计划现在可以独立于作业进行管理。若要向作业中添加计划，请使用 sp_add_schedule 创建计划，然后使用 sp_attach_schedule 将该计划附加到作业。

<script type="text/Javascript"> var ExpCollDivStr = ExpCollDivStr; ExpCollDivStr = ExpCollDivStr + "ctl00_LibFrame_ctl065a53780,"; var ExpCollImgStr = ExpCollImgStr; ExpCollImgStr = ExpCollImgStr + "ctl00_LibFrame_ctl06img,"; </script> 返回代码值

0（成功）或 1（失败）

<script type="text/Javascript"> var ExpCollDivStr = ExpCollDivStr; ExpCollDivStr = ExpCollDivStr + "ctl00_LibFrame_ctl079eca3cf,"; var ExpCollImgStr = ExpCollImgStr; ExpCollImgStr = ExpCollImgStr + "ctl00_LibFrame_ctl07img,"; </script> 结果集

无

<script type="text/Javascript"> var ExpCollDivStr = ExpCollDivStr; ExpCollDivStr = ExpCollDivStr + "ctl00_LibFrame_ctl0800fe3ee,"; var ExpCollImgStr = ExpCollImgStr; ExpCollImgStr = ExpCollImgStr + "ctl00_LibFrame_ctl08img,"; </script> 权限

默认情况下，只有 sysadmin 固定服务器角色的成员才可以执行此存储过程。其他用户必须被授予 msdb 数据库中下列 SQL Server 代理固定数据库角色的权限之一：

• SQLAgentUserRole
  
• SQLAgentReaderRole
  
• SQLAgentOperatorRole
  

有关这些角色的权限的详细信息，请参阅 SQL Server 代理固定数据库角色。