sp_detach_schedule (języka Transact-SQL)

Usuwa skojarzenie między harmonogram i zadanie.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

sp_detach_schedule 
     { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,
       { [ @schedule_id = ] schedule_id | [ @schedule_name = ] 'schedule_name' } ,
     [ @delete_unused_schedule = ] delete_unused_schedule 

Argumenty

  • [ @job_id= ] job_id
    Numer identyfikacyjny zadanie zadanie , aby usunąć harmonogram od.job_idjest uniqueidentifier, domyślna wartość NULL.

  • [ @job_name= ] 'job_name'
    Nazwa zadanie , aby usunąć harmonogram od.job_namejest sysname, domyślna wartość NULL.

    Ostrzeżenie

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

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

  • [ @ schedule_name= ] 'schedule_name"
    Nazwa harmonogramu do usunięcia z zadanie.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.

  • [ @ delete_unused_schedule= ] delete_unused_schedule
    Określa, czy należy usunąć nieużywane zadanie harmonogramów.delete_unused_schedulejest bit, domyślnie 0, co oznacza że zostaną zachowane wszystkie harmonogramy, nawet, jeśli żadne zadania odwołuje się do nich.Jeśli zestaw na 1, harmonogramy nieużywane zadanie są usuwane, jeśli zadania nie odwołuje się do nich.

Wartości kodów powrotnych

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

Zestawy wyników

Brak

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.

SQL Serversprawdza, czy użytkownik jest właścicielem harmonogramu.Tylko członkowie sysadmin stała rola serwera można odłączyć harmonogramy z zadań należących do innego użytkownika.

Przykłady

W następującym przykładzie usunięto skojarzenie między 'NightlyJobs' harmonogramu i 'BackupDatabase' zadanie.

USE msdb ;
GO

EXEC dbo.sp_detach_schedule
    @job_name = 'BackupDatabase',
    @schedule_name = 'NightlyJobs' ;
GO