Udostępnij za pośrednictwem


sp_delete_schedule (języka Transact-SQL)

Składnia

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

Argumenty

  • [ @schedule_id= ] schedule_id
    Numer identyfikacyjny harmonogramu harmonogram do usunięcia.schedule_idjest int, domyślna wartość NULL.

    Ostrzeżenie

    Albo schedule_id lub schedule_name musi być określona, ale nie może być jednocześnie określone.

  • [ @ schedule_name= ] 'schedule_name"
    Nazwa harmonogramu do usunięcia.schedule_namejest sysname, domyślna wartość NULL.

    Ostrzeżenie

    Albo schedule_id lub schedule_name musi być określona, ale nie może być jednocześnie określone.

  • [ @ force_delete =] force_delete
    Określa, czy procedury powinny zakończyć się niepowodzeniem, jeśli harmonogram jest dołączony do zadanie.Force_deletejest bit domyślną 0.Gdy force_delete jest 0, procedura składowana kończy się niepowodzeniem, jeśli harmonogram jest dołączony do zadanie.Gdy force_delete jest 1, harmonogram skreśla się niezależnie od tego, czy harmonogram jest dołączony do zadanie.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Zestawy wyników

Brak

Uwagi

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 dla force_delete.Usuwanie harmonogramu nie zatrzymuje zadania, które są aktualnie uruchomione.

Uprawnienia

Domyślnie członkowie sysadmin stała rola serwera można wykonać tę procedura składowana.Inni użytkownicy muszą być przyznawane jedną z następujących SQL Server Agent ról stałej bazy danych w msdb bazy danych:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Szczegółowe informacje na temat uprawnień tych ról, zobacz Ról stałej bazy danych programu SQL Server Agent.

Tylko członkowie sysadmin roli można usunąć harmonogram zadanie , który jest w posiadaniu innego użytkownika.

Przykłady

A.Usuwanie harmonogramu

W następującym przykładzie usunięto harmonogram NightlyJobs.Jeśli harmonogram jest dołączony do dowolnego zadanie, przykład 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 harmonogram 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