共用方式為


sp_delete_schedule (Transact-SQL)

刪除排程。

主題連結圖示Transact-SQL 語法慣例

語法

sp_delete_schedule { [ @schedule_id = ] schedule_id | [ @schedule_name = ] 'schedule_name' } ,
     [ @force_delete = ] force_delete

引數

  • [@schedule_id= ] schedule_id
    這是要停止的作業識別碼。schedule_id 是 int,預設值是 NULL。

    [!附註]

    您必須指定 schedule_id 或 schedule_name,但不能同時指定這兩者。

  • [@schedule_name= ] 'schedule_name'
    這是要刪除的排程名稱。schedule_name 是 sysname,預設值是 NULL。

    [!附註]

    您必須指定 schedule_id 或 schedule_name,但不能同時指定這兩者。

  • [@force_delete = ] force_delete
    指定如果排程附加至作業,程序是否會失敗。Force_delete 是 bit,預設值是 0。當 force_delete 是 0 時,如果排程附加至作業,預存程序會失敗。當 force_delete 是 1 時,不論排程是否附加至作業中,都會刪除排程。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

備註

依預設,如果排程附加至作業中,並無法刪除排程。若要刪除附加至作業的排程,請將 force_delete 的值指定為 1。刪除排程,並不會停止目前在執行中的作業。

權限

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

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

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

只有系統管理員 (sysadmin) 角色的成員,才能夠刪除另一位使用者所擁有的作業排程。

範例

A. 刪除排程

下列範例會刪除 NightlyJobs 排程。如果這份排程附加至任何作業中,這個範例便不會刪除這份排程。

USE msdb ;
GO

EXEC dbo.sp_delete_schedule
    @schedule_name = N'NightlyJobs' ;
GO

B. 刪除附加至作業中的排程

下列範例會刪除 RunOnce 排程,不論排程是否附加至作業中都是如此。

USE msdb ;
GO

EXEC dbo.sp_delete_schedule
    @schedule_name = 'RunOnce',
    @force_delete = 1;
GO