sp_delete_schedule (Transact-SQL)
Usuwa harmonogram.
sp_delete_schedule { [ @schedule_id = ] schedule_id | [ @schedule_name = ] 'schedule_name' } ,
[ @force_delete = ] force_delete
Argumenty
[ @schedule_id= ] schedule_id
The schedule identification number of the schedule to delete.schedule_id is int, with a default of NULL.Uwaga
Albo schedule_id lub schedule_name musi być określona, ale nie może być jednocześnie określone.
[ @schedule_name= ] 'schedule_name'
The name of the schedule to delete.schedule_name is sysname, with a default of NULL.Uwaga
Albo schedule_id lub schedule_name musi być określona, ale nie może być jednocześnie określone.
[ @ force_delete = ] force_delete
Specifies whether the procedure should fail if the schedule is attached to a job.Force_delete is bit, with a default of 0.Kiedy force_delete jest 0, procedura przechowywana kończy się niepowodzeniem, jeśli harmonogram jest dołączony do zadanie.Kiedy force_delete jest 1, harmonogram jest usuwany, niezależnie od tego, czy harmonogram jest dołączony do zadanie.
Wartości kodów powrotnych
0 (sukces) lub 1 (brak)
Zestawy wyników
None
Remarks
Domyślnie harmonogram nie można usunąć, jeśli harmonogram jest dołączony do zadanie.Aby usunąć harmonogram, który jest dołączony do zadanie, należy określić wartość 1 for force_delete. Usuwanie harmonogramu nie zatrzymuje zadania, które są aktualnie uruchomione.
Uprawnienia
Domyślnie członkowie sysadmin stała rola serwera możliwość wykonać tej procedura przechowywana.Inni użytkownicy klastrowa musi mieć jedną z następujących czynności SQL Server Agent stałe role bazy danych w msdb bazy danych:
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
Aby uzyskać szczegółowe informacje o uprawnieniach z tych ról zobacz SQL Server Agent Fixed Database Roles.
Tylko członkowie sysadmin roli, można usunąć harmonogram zadanie, którego właścicielem jest inny użytkownik.
Przykłady
A.Usuwanie harmonogramu
W następującym przykładzie usunięto harmonogramu NightlyJobs. Jeśli harmonogram jest dołączony do dowolnego zadanie, w przykładzie nie powoduje usunięcia harmonogramu.
USE msdb ;
GO
EXEC dbo.sp_delete_schedule
@schedule_name = N'NightlyJobs' ;
GO
B.Usuwanie harmonogramu dołączonych do zadanie
W następującym przykładzie usunięto harmonogramu RunOnce, niezależnie od tego, czy harmonogram jest dołączony do zadanie.
USE msdb ;
GO
EXEC dbo.sp_delete_schedule
@schedule_name = 'RunOnce',
@force_delete = 1;
GO