共用方式為

sp_delete_job (Transact-SQL)

  • 發行項

刪除作業。

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

請參閱

參考

sp_add_job (Transact-SQL)

sp_help_job (Transact-SQL)

sp_update_job (Transact-SQL)

系統預存程序 (Transact-SQL)