sp_attach_schedule (Transact-SQL)

适用于SQL Server

设置一个作业计划。

Transact-SQL 语法约定

语法

sp_attach_schedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @automatic_post = ] automatic_post ]
[ ; ]

参数

[ @job_id = ] 'job_id'

向其中添加计划的作业的标识号。 @job_id是 uniqueidentifier,默认值为 NULL.

必须指定@job_id@job_name,但不能指定这两者。

[ @job_name = ] N'job_name'

将计划添加到的作业的名称。 @job_name为 sysname,默认值为 NULL.

必须指定@job_id@job_name,但不能指定这两者。

[ @schedule_id = ] schedule_id

为作业设置的计划的标识号。 @schedule_id为 int,默认值为 NULL.

必须指定@schedule_id@schedule_name,但不能指定两者。

[ @schedule_name = ] N'schedule_name'

为作业设置的计划的名称。 @schedule_name为 sysname,默认值为 NULL.

必须指定@schedule_id@schedule_name,但不能指定两者。

[ @automatic_post = ] automatic_post

@automatic_post,默认值为 1.

注解

计划和作业的所有者必须相同。

可以为多个作业设置一个计划。 可以根据多个计划运行作业。

必须从 msdb 数据库运行此存储过程。

权限

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限,但这些权限可能会在 SQL Server 升级期间被重写。

其他用户必须被授予数据库中以下SQL Server 代理固定数据库角色msdb之一:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

作业所有者可以将作业附加到计划,并从计划中分离作业,而无需成为计划所有者。 但是,如果分离将不带任何作业,则无法删除计划,除非调用方是计划所有者。

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

SQL Server 检查用户是否同时拥有作业和计划。

示例

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

注意

此示例假定作业 BackupDatabase 和作业 RunReports 已存在。

USE msdb;
GO

EXEC sp_add_schedule
    @schedule_name = N'NightlyJobs' ,
    @freq_type = 4,
    @freq_interval = 1,
    @active_start_time = 010000 ;
GO

EXEC sp_attach_schedule
   @job_name = N'BackupDatabase',
   @schedule_name = N'NightlyJobs' ;
GO

EXEC sp_attach_schedule
   @job_name = N'RunReports',
   @schedule_name = N'NightlyJobs' ;
GO