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