sp_delete_jobstep (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 托管实例

从SQL Server 代理服务中的作业中删除作业步骤。

Transact-SQL 语法约定

语法

sp_delete_jobstep
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    , [ @step_id = ] step_id
[ ; ]

参数

[ @job_id = ] 'job_id'

从中删除步骤的作业的标识号。 @job_id是 uniqueidentifier，默认值为 NULL.

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

[ @job_name = ] N'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会删除作业的所有作业步骤。

SQL Server Management Studio 为管理作业提供了一种图形化的简便方法，建议使用此方法来创建和管理作业基础结构。

此存储过程与用于Azure SQL 数据库的 Azure 弹性作业服务的类似对象共享名称sp_delete_jobstep。 有关弹性作业版本的信息，请参阅jobs.sp_delete_jobstep（Azure 弹性作业）（Transact-SQL）。

权限

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

其他用户必须被授予数据库中以下SQL Server 代理固定数据库角色msdb之一：

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

有关这些角色的权限的详细信息，请参阅 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

相关内容