sp_delete_jobstep (Transact-SQL)
適用於:SQL Server Azure SQL 受控執行個體
從 SQL Server Agent 服務中的作業中移除作業步驟。
語法
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