sp_delete_jobstep (Transact-SQL)

  • 發行項

適用於：SQL ServerAzure 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） （Transact-SQL） 。

權限

此預存程式是由 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

相關內容