sp_delete_schedule (Transact-SQL)

删除计划。

适用范围：SQL Server（SQL Server 2008 到当前版本）。

语法

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 代理固定数据库角色的权限之一：

请注意，作业所有者可以将作业附加到计划以及从计划中分离作业，而不必要求也是计划所有者。但是，如果分离后导致无作业，除非调用方是计划所有者，否则不能删除计划。

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

只有 sysadmin 角色的成员才可以删除其他用户拥有的作业计划。

以下示例删除计划 NightlyJobs。如果该计划已附加到任何作业，则此示例不会删除该计划。

USE msdb ;
GO

EXEC dbo.sp_delete_schedule
    @schedule_name = N'NightlyJobs' ;
GO

以下示例删除计划 RunOnce，无论该计划是否已附加到作业。

USE msdb ;
GO

EXEC dbo.sp_delete_schedule
    @schedule_name = 'RunOnce',
    @force_delete = 1;
GO