sp_delete_schedule (Transact-SQL)

适用于: 是SQL Server(所有支持的版本)

删除计划。

主题链接图标 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_idschedule_name ,但不能同时指定两者。

[ @schedule_name = ] 'schedule_name' 要删除的计划的名称。 schedule_name 的默认值为 sysname,默认值为 NULL。

注意: 必须指定 schedule_idschedule_name ,但不能同时指定两者。

[ @force_delete = ] force_delete 指定在将计划附加到作业时,该过程是否应失败。 Force_delete 为 bit,默认值为 0。 当 force_delete0 时,如果将计划附加到作业,则存储过程将失败。 当 force_delete1 时,将删除计划,而不考虑是否将计划附加到作业。

返回代码值

0 (成功) 或 1 (失败)

结果集

备注

默认情况下,如果将计划附加到作业,则无法删除计划。 若要删除附加到作业的计划,请将 force_delete 的值指定为 1 。 删除计划不会停止当前正在运行的作业。

权限

默认情况下,只有 sysadmin 固定服务器角色的成员才可以执行此存储过程。 其他用户必须被授予 SQL Server msdb 数据库中下列 代理固定数据库角色的权限之一:

  • 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)