sp_attach_schedule (Transact-SQL)

设置一个作业计划。

主题链接图标Transact-SQL 语法约定

语法

sp_attach_schedule
     { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } , 
     { [ @schedule_id = ] schedule_id 
     | [ @schedule_name = ] 'schedule_name' }

参数

  • [ @job_id= ] job_id
    向其中添加计划的作业的标识号。job_id 的数据类型为 uniqueidentifier,默认值为 NULL。

  • [ @job_name = ] 'job_name'
    向其中添加计划的作业的名称。job_name 的数据类型为 sysname,默认值为 NULL。

    注意注意

    必须指定 job_id 或 job_name,但不能两个都指定。

  • [ @schedule_id = ] schedule_id
    为作业设置的计划的标识号。schedule_id 的数据类型为 int,默认值为 NULL。

  • [ @schedule_name = ] 'schedule_name'
    为作业设置的计划的名称。schedule_name的数据类型为 sysname,默认值为 NULL。

    注意注意

    必须指定 schedule_id 或 schedule_name,但不能两个都指定。

注释

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

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

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

权限

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

  • 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