本主题介绍了如何使用存储过程修改 Microsoft SQL Server 代理主作业。

 更改作业定义计划的详细信息

1.       执行 sp_update_schedule。

 在作业中添加、更改或删除步骤

1.       执行 sp_add_jobstep 来添加新的作业步骤。

2.       执行 sp_update_jobstep 来更改原先存在的作业步骤。

3.       执行 sp_delete_jobstep 来删除原先存在的作业。

 修改与作业相关联的目标服务器

1.       执行 sp_delete_jobserver 来删除当前与作业相关联的服务器。

2.       执行 sp_add_jobserver 将某个服务器与当前作业相关联。

sp_add_schedule (Transact-SQL)

更新日期： 2007 年 2 月 1 日

创建一个可由任意数量的作业使用的计划。

 语法

 参数

[ @schedule_name = ] ‘schedule_name‘

计划的名称。schedule_name 的数据类型为 sysname，无默认值。

[ @enabled = ] enabled

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

[ @freq_type = ] freq_type

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

[ @freq_interval = ] freq_interval

作业执行的天数。freq_interval 的数据类型为 int，默认值为 1，该值依赖于 freq_type 的值。

[ @freq_subday_type = ] freq_subday_type

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

[ @freq_subday_interval = ] freq_subday_interval

每次执行作业之间出现的 freq_subday_type 期间数。freq_subday_interval 为 int，默认值为 0。在 freq_subday_type 等于 1 的情况下将忽略 freq_subday_interval。

[ @freq_relative_interval = ] freq_relative_interval

如果 freq_type 为 32（与“每月”选项相关），则为每个月中作业的 freq_interval 的执行频率。freq_relative_interval 为 int，默认值为 0，并可以成为这些值中的一个。在freq_type 不等于 32 的情况下将忽略 freq_relative_interval。

[ @freq_recurrence_factor = ] freq_recurrence_factor

作业的两次计划执行之间的间隔周数或月数。只有 freq_type 为 8、16 或 32 时，才会使用 freq_recurrence_factor。freq_recurrence_factor 的数据类型为 int，默认值为0。

[ @active_start_date = ] active_start_date

开始执行作业的日期。active_start_date 的数据类型为 int，默认值为 NULL，指示当天的日期。日期的格式为 YYYYMMDD。如果 active_start_date 不为 NULL，则日期必须大于或等于 19900101。

[ @active_end_date = ] active_end_date

停止执行作业的日期。active_end_date 的数据类型为 int，默认值为 99991231，指示 9999 年 12 月 31 日。格式为 YYYYMMDD。

[ @active_start_time = ] active_start_time

在 active_start_date 和 active_end_date 之间的任何一天开始执行作业的时间。active_start_time 的数据类型为 int，默认值为 000000，指示 24 小时制的上午12:00:00，并且必须使用 HHMMSS 的格式输入。

[ @active_end_time = ] active_end_time

在 active_start_date 和 active_end_date 之间任何一天停止执行作业的时间。active_end_time 的数据类型为 int，默认值为 235959，指示 24 小时制的晚上 11:59:59，必须使用 HHMMSS 的格式输入。

[ @owner_login_name= ] ‘owner_login_name‘

拥有该计划的服务器主体的名称。owner_login_name 的数据类型为 sysname，默认值为 NULL，指示计划由创建者拥有。

[ @schedule_uid= ] schedule_uid OUTPUT

计划的唯一标识符。schedule_uid 是数据类型为 uniqueidentifier 的变量。

[ @schedule_id= ] schedule_id OUTPUT

计划的标识符。schedule_id 是数据类型为 int 的变量。

[ @originating_server= ] server_name

保留为仅供 SQL Server 内部使用。不保证以后的兼容性。

 返回代码值

0（成功）或 1（失败）

 结果集

无

 备注

SQL Server Management Studio 为管理作业提供了一种图形化的简便方法，建议使用此方法来创建和管理作业基础结构。

 权限

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

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

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

 示例

A. 创建计划

以下示例将创建一个名为 RunOnce 的计划：此计划在创建当天的 23:30 运行一次。

B. 创建计划，将计划附加到多个作业

以下示例将创建一个名为 NightlyJobs 的计划：使用此计划的作业每天在服务器时间为 01:00 时执行。该示例此计划附加到作业 BackupDatabase 和作业 RunReports。

SQL Server 2005 联机丛书（2007 年 9 月）

sp_update_schedule (Transact-SQL)

更改 SQL Server 代理计划的设置。

 语法

 参数

[ @schedule_id = ] schedule_id

要修改的计划的标识符。schedule_id 的数据类型为 int，无默认值。必须指定 schedule_id 或 schedule_name。

[ @name = ] ‘schedule_name‘

要修改的计划的名称。schedule_name 的数据类型为 sysname，无默认值。必须指定 schedule_id 或 schedule_name。

[ @new_name= ] new_name

计划的新名称。new_name 的数据类型为 sysname，默认值为 NULL。如果 new_name 为 NULL，则不更改计划名称。

[ @enabled = ] enabled

指示计划的当前状态。enabled 的数据类型为 tinyint，默认值为 1（启用）。如果为 0，则不启用计划。如果不启用计划，则作业不会按此计划运行。

[ @freq_type = ] freq_type

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

[ @freq_interval = ] freq_interval

作业执行的天数。freq_interval 的数据类型为 int，默认值为 0，该值取决于 freq_type 的值。

[ @freq_subday_type = ] freq_subday_type

指定 freq_subday_interval 的单位。freq_subday_type 的数据类型为 int，默认值为 0，可以是下列值之一。

[ @freq_subday_interval = ] freq_subday_interval

作业的每次执行之间间隔的 freq_subday_type 周期数。freq_subday_interval 的数据类型为 int，默认值为 0。

[ @freq_relative_interval = ] freq_relative_interval

freq_interval 为 32（与“每月”选项相关）时，每月中作业的 freq_interval 的执行频率。freq_relative_interval 的数据类型为 int，默认值为 0，可以是下列值之一。

[ @freq_recurrence_factor = ] freq_recurrence_factor

作业的两次计划执行之间的间隔周数或月数。只有 freq_type 为 8、16 或 32 时，才会使用freq_recurrence_factor。freq_recurrence_factor 的数据类型为 int，默认值为 0。

[ @active_start_date = ] active_start_date

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

[ @active_end_date = ] active_end_date

停止执行作业的日期。active_end_date 的数据类型为 int，默认值为 99991231，指示 9999 年 12 月 31 日。格式为 YYYYMMDD。

[ @active_start_time = ] active_start_time

在 active_start_date 和 active_end_date 之间的任何一天开始执行作业的时间。active_start_time 的数据类型为 int，默认值为 000000，指示 24 小时制的上午12:00:00，并且必须使用 HHMMSS 格式输入。

[ @active_end_time = ] active_end_time

在 active_start_date 和 active_end_date 之间任何一天停止执行作业的时间。active_end_time 的数据类型为 int，默认值为 235959，指示 24 小时制的晚上 11:59:59，必须使用 HHMMSS 的格式输入。

[ @owner_login_name= ] ‘owner_login_name‘]

拥有该计划的服务器主体的名称。owner_login_name 的数据类型为 sysname，默认值为 NULL，指示计划由创建者拥有。

[ @automatic_post =] automatic_post

保留。

 返回代码值

0（成功）或 1（失败）

 备注

所有使用该计划的作业将立即使用新设置。但是，更改计划不会停止当前正在运行的作业。

 权限

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

• SQLAgentUserRole
• SQLAgentReaderRole
• SQLAgentOperatorRole

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

只有 sysadmin 的成员才可以修改其它用户拥有的计划。

如何修改 SQL Server 代理主作业 (Transact-SQL)