sp_delete_schedule (Transact-SQL)

Usuwa harmonogram.

Konwencje składni języka Transact-SQL

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

See Also

Reference

sp_add_schedule (języka Transact-SQL)

Other Resources

Implementing Jobs