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。

    ms175050.note(zh-cn,SQL.90).gif注意:
    必须指定 schedule_idschedule_name,但不能两个都指定。
  • [ @schedule_name= ] 'schedule_name'
    要删除的计划的名称。schedule_name 的数据类型为 sysname,默认值为 NULL。

    ms175050.note(zh-cn,SQL.90).gif注意:
    必须指定 schedule_idschedule_name,但不能两个都指定。
  • [ @force_delete = ] force_delete
    指定当计划附加到作业时此过程是否会失败。Force_delete 的数据类型为 bit,默认值为 0。当 force_delete0 时,如果将计划附加到作业,则存储过程会失败。当 force_delete1 时,无论是否将计划附加到作业,都会删除计划。

返回代码值

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)

其他资源

执行作业

帮助和信息

获取 SQL Server 2005 帮助