sp_attach_schedule (Transact-SQL)

  • 项目

适用于：SQL Server

设置一个作业计划。

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

另请参阅

sp_add_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)