sp_delete_schedule (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 固定資料庫角色。

請注意，作業擁有者不需要也是排程擁有者，就可以將作業附加到排程，也可以從排程卸離作業。不過，如果卸離之後不會在排程中留下任何作業，除非呼叫端是排程擁有者，否則無法刪除該排程。

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

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

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

USE msdb ;
GO

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

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

USE msdb ;
GO

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