sp_delete_jobstep (Transact-SQL)

从作业中删除作业步骤。

语法

  
sp_delete_jobstep { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,   
     [ @step_id = ] step_id

[ @job_id = ] job_id 要从中删除步骤的作业的标识号。 job_id为 uniqueidentifier，默认值为 NULL。

[ @job_name = ] 'job_name' 将从中删除步骤的作业的名称。 job_name为 sysname，默认值为 NULL。

注意

必须指定 job_id 或 job_name ;两者都不能指定。

[ @step_id = ] step_id 要删除的步骤的标识号。 step_id为 int，无默认值。

0 (成功) 或 1 (失败)

无

删除作业步骤将自动更新引用此步骤的其他作业步骤。

有关与特定作业关联的步骤的详细信息， 请运行 sp_help_jobstep。

注意

调用 step_id 值为零的 sp_delete_jobstep 会删除作业的所有作业步骤。

Microsoft SQL Server Management Studio 提供易于使用的图形方法来管理作业，建议使用该方法创建和管理作业基础结构。

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

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

只有 sysadmin 的成员才能删除其他用户拥有的作业步骤。

以下是从作业 1 中删除作业步骤 Weekly Sales Data Backup 的示例。

USE msdb ;  
GO  
  
EXEC dbo.sp_delete_jobstep  
    @job_name = N'Weekly Sales Data Backup',  
    @step_id = 1 ;  
GO