分享方式:


sp_delete_jobstep (Transact-SQL)

適用於:SQL Server Azure SQL 受控執行個體

從 SQL Server Agent 服務中的作業中移除作業步驟。

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 Elastic Jobs 服務類似物件共用 的名稱sp_delete_jobstep。 如需彈性作業版本的相關信息,請參閱 jobs.sp_delete_jobstep (Azure Elastic Jobs)

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權,但這些許可權可能會在 SQL Server 升級期間覆寫。

其他用戶必須在資料庫中獲得下列其中一個 SQL Server Agent 固定資料庫角色 msdb

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

如需這些角色權限的詳細資訊,請參閱 SQL Server Agent 固定資料庫角色

只有系統管理員的成員可以刪除其他用戶所擁有的作業步驟。

範例

下列範例會從作業 中移除作業Weekly Sales Data Backup步驟1

USE msdb;
GO

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