sp_attach_schedule (Transact-SQL)
适用范围:SQL Server
设置一个作业计划。
语法
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
数据库运行此存储过程。
权限
可以授予 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