sp_delete_job (Transact-SQL)

語法

sp_delete_job { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,
     [ , [ @originating_server = ] 'server' ] 
     [ , [ @delete_history = ] delete_history ]
     [ , [ @delete_unused_schedule = ] delete_unused_schedule ]

引數

• [@job_id= ] job_id
  這是要刪除之作業的識別碼。job_id 是 uniqueidentifier，預設值是 NULL。

• [@job_name= ] 'job_name'
  這是要刪除的作業名稱。job_name 是 sysname，預設值是 NULL。

  [!附註]

  您必須指定 job_id 或 job_name，但不能同時指定這兩者。

• [@originating_server= ] 'server'
  供內部使用。

• [@delete_history= ] delete_history
  指定是否刪除作業的記錄。delete_history 是 bit，預設值是 1。當 delete_history 是 1 時，會刪除作業的作業記錄。當 delete_history 是 0 時，不會刪除作業記錄。

  請注意，當只刪除作業而不刪除記錄時，作業的記錄資訊並不會出現在 SQL Server Agent 圖形化使用者介面作業記錄中，不過，msdb 資料庫的 sysjobhistory 資料表仍會保留這項資訊。

• [@delete_unused_schedule= ] delete_unused_schedule
  指定當附加至這項作業的排程並未附加至任何其他作業時，是否刪除這些排程。delete_unused_schedule 是 bit，預設值是 1。當 delete_unused_schedule 是 1 時，如果沒有任何其他作業參考附加至這項作業的排程，便刪除這些排程。當 delete_unused_schedule 是 0 時，不會刪除這些排程。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

無

備註

保留 @originating_server 引數，供內部使用。

@delete_unused_schedule 引數會自動移除未附加至任何作業的排程，用來相容於舊版的 SQL Server。請注意，這個參數預設相容於舊版的行為。若要保留未附加至作業的排程，您必須在 @delete_unused_schedule 引數中提供 0 值。

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

這個預存程序無法刪除維護計畫，也無法刪除在維護計畫中的作業。請改用 SQL Server Management Studio 來刪除維護計畫。

權限

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

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行 sp_delete_job 來刪除任何作業。本身不是系統管理員 (sysadmin) 固定伺服器角色成員的使用者只能刪除其本身所擁有的作業。

範例

下列範例會刪除 NightlyBackups 作業。

USE msdb ;
GO

EXEC sp_delete_job
    @job_name = N'NightlyBackups' ;
GO

請參閱

參考