sp_delete_schedule (Transact-SQL)

适用于SQL Server

删除计划。

Transact-SQL 语法约定

语法

sp_delete_schedule
    [ [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @force_delete = ] force_delete ]
    [ , [ @automatic_post = ] automatic_post ]
[ ; ]

参数

[ @schedule_id = ] schedule_id

要删除的计划的标识号。 @schedule_id为 int,默认值为 NULL.

必须指定@schedule_id@schedule_name,但不能指定两者。

[ @schedule_name = ] N'schedule_name'

要删除的计划的名称。 @schedule_name为 sysname,默认值为 NULL.

必须指定@schedule_id@schedule_name,但不能指定两者。

[ @force_delete = ] force_delete

指定当计划附加到作业时此过程是否会失败。 @force_delete为,默认值为 0.

  • 当@force_delete0,如果计划附加到作业,存储过程将失败。
  • 当@force_delete1,无论计划是否附加到作业,都会删除该计划。

[ @automatic_post = ] automatic_post

标识为仅供参考。 不支持。 不保证以后的兼容性。

返回代码值

0(成功)或 1(失败)。

结果集

无。

注解

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

权限

此存储过程由 db_owner 角色拥有。 你可以为任何用户授予 EXECUTE 权限,但这些权限可能会在 SQL Server 升级期间被重写。

其他用户必须被授予数据库中以下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