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。
附註: |
---|
利用其值為 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
請參閱
參考
sp_add_jobstep (Transact-SQL)
sp_update_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
系統預存程序 (Transact-SQL)