sp_delete_schedule (Transact-SQL)
删除计划。
语法
sp_delete_schedule { [ @schedule_id = ] schedule_id | [ @schedule_name = ] 'schedule_name' } ,
[ @force_delete = ] force_delete
参数
[ @schedule_id= ] schedule_id
要删除的计划的标识号。schedule_id 的数据类型为 int,默认值为 NULL。注意: 必须指定 schedule_id 或 schedule_name,但不能两个都指定。
[ @schedule_name= ] 'schedule_name'
要删除的计划的名称。schedule_name 的数据类型为 sysname,默认值为 NULL。注意: 必须指定 schedule_id 或 schedule_name,但不能两个都指定。
- [ @force_delete = ] force_delete
指定当计划附加到作业时此过程是否会失败。Force_delete 的数据类型为 bit,默认值为 0。当 force_delete 为 0 时,如果将计划附加到作业,则存储过程会失败。当 force_delete 为 1 时,无论是否将计划附加到作业,都会删除计划。
返回代码值
0(成功)或 1(失败)
结果集
无
备注
默认情况下,如果将计划附加到作业,则无法删除计划。若要删除附加到作业的计划,请为 force_delete 指定值 1。删除计划不会停止当前正在运行的作业。
权限
默认情况下,只有 sysadmin 固定服务器角色的成员才可以执行此存储过程。其他用户必须被授予 msdb 数据库中下列 SQL Server 代理固定数据库角色的权限之一:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
有关这些角色的权限的详细信息,请参阅 SQL Server 代理固定数据库角色。
只有 sysadmin 角色的成员才可以删除其他用户拥有的作业计划。
示例
A. 删除计划
以下示例删除计划 NightlyJobs
。如果该计划已附加到任何作业,则此示例不会删除该计划。
USE msdb ;
GO
EXEC dbo.sp_delete_schedule
@schedule_name = N'NightlyJobs' ;
GO
B. 删除附加到作业的计划
以下示例删除计划 RunOnce
,无论该计划是否已附加到作业。
USE msdb ;
GO
EXEC dbo.sp_delete_schedule
@schedule_name = 'RunOnce',
@force_delete = 1;
GO
请参阅
参考
sp_add_schedule (Transact-SQL)