共用方式為


sp_delete_jobstep (Transact-SQL)

從作業中移除作業步驟。

主題連結圖示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

[!附註]

利用其值為 0 的 step_id 來呼叫 sp_delete_jobstep,會刪除作業的所有作業步驟。

Microsoft SQL Server Management Studio 提供了一種簡單的圖形方式供您管理各項作業,建議您利用這個方式來建立和管理作業基礎結構。

權限

依預設,只有系統管理員 (sysadmin) 固定伺服器角色的成員,才能夠執行這個預存程序。其他使用者必須被授與 msdb 資料庫的下列其中一個 SQL Server Agent 固定資料庫角色。

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

如需有關這些角色權限的詳細資料,請參閱<SQL Server Agent 固定資料庫角色>。

只有系統管理員 (sysadmin) 的成員,才能夠刪除另一位使用者所擁有的作業步驟。

範例

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

USE msdb ;
GO

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