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. 删除计划

USE msdb ;
GO

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

B. 删除附加到作业的计划

USE msdb ;
GO

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

请参阅

参考

概念