• Artykuł

sp_delete_job (języka Transact-SQL)

Usuwa zadanie.

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

Składnia

sp_delete_job { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,
     [ , [ @originating_server = ] 'server' ] 
     [ , [ @delete_history = ] delete_history ]
     [ , [ @delete_unused_schedule = ] delete_unused_schedule ]

Argumenty

  • [ @job_id= ] job_id
    To numer identyfikacyjny zadanie mają zostać usunięte.job_idjest uniqueidentifier, domyślna wartość NULL.

  • [ @job_name= ] 'job_name'
    Jest to nazwa zadanie mają zostać usunięte.job_namejest sysname, domyślna wartość NULL.

    Ostrzeżenie

    Albo job_id lub job_namemuszą być określone; nie może być jednocześnie określone.

  • [ @ originating_server= ] 'server"
    Do użytku wewnętrznego.

  • [ @ delete_history= ] delete_history
    Określa, czy usunąć historia zadanie.delete_historyjest bit, domyślnie 1.Gdy delete_history jest 1, zadanie historia dla zadanie jest usuwana.Gdy delete_history jest 0,historia zadanienie jest usuwany.

    Należy zauważyć, że gdy trzeba usunąć zadanie i historia nie zostanie usunięty, historyczne informacje dla zadanie nie są wyświetlane w SQL Serverhistoriazadanie interfejsgraficznego agenta, ale informacje będą nadal znajdują się w sysjobhistory tabela w msdb bazy danych.

  • [ @ delete_unused_schedule= ] delete_unused_schedule
    Określa, czy usunąć harmonogramy dołączony do tego zadanie , jeśli nie są dołączone do wszelkich innych, zadanie.delete_unused_schedulejest bit, domyślnie 1.Gdy delete_unused_schedule jest 1, list koncesyjnych załączonych do tego zadanie są usuwane, jeśli inne zadania odwołuje się do harmonogramu.Gdy delete_unused_schedule jest 0, harmonogramy nie są usuwane.

Wartości kodów powrotnych

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

Zestawy wyników

Brak

Uwagi

@ Originating_server argument jest zarezerwowana do użytku wewnętrznego.

@ Delete_unused_schedule argument zapewnia zgodność z poprzednimi wersjami programu SQL Server przez automatyczne usuwanie harmonogramów, które nie są dołączone do dowolnego zadanie.Należy zauważyć, że ten parametr domyślne zachowanie starszymi wersjami.Aby zachować harmonogramy, które nie są dołączone do zadanie, należy podać wartość 0 jako @ delete_unused_schedule argumentu.

SQL Server Management Studiozapewnia łatwe, graficzny sposób Zarządzanie zadaniami i jest zalecanym sposobem tworzenia i zarządzania infrastrukturą zadanie .

Ta procedura składowana nie można usunąć planów konserwacji i nie można usunąć zadania, które są częścią planów konserwacji.Zamiast tego należy użyć SQL Server Management Studio do usuwania planów konserwacji.

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.

Członkowie sysadmin stała rola serwera można wykonać sp_delete_job usunąć wszystkie zadanie.Użytkownik, który nie jest elementem element członkowski z sysadmin stała rola serwera można usuwać tylko zadań należących do tego użytkownika.

Przykłady

W następującym przykładzie usunięto zadanie NightlyBackups.

USE msdb ;
GO

EXEC sp_delete_job
    @job_name = N'NightlyBackups' ;
GO