Artykuł
05/11/2010

sp_delete_job (języka Transact-SQL)

Usuwa zadanie.

Topic link icon Konwencje składni języka Transact-SQL

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
Is the identification number of the job to be deleted.job_id is uniqueidentifier, with a default of NULL.
[ @job_name= ] 'job_name'
Is the name of the job to be deleted.job_name is sysname, with a default of NULL.

Uwaga

Either job_id or job_namemust be specified; both cannot be specified.
[ @originating_server= ] 'server'
Do użytku wewnętrznego.
[ @delete_history= ] delete_history
Specifies whether to delete the history for the job.delete_history is bit, with a default of 1.Kiedy delete_history jest 1, historia zatrudnienia dla zadanie jest usuwany.Kiedy delete_history jest 0, historia zatrudnienia nie zostanie usunięty.

Należy zauważyć, że gdy zadanie są usuwane i historii nie zostanie usunięty, informacji o historii zadanie nie będą wyświetlane w SQL Server Historia zatrudnienia interfejs graficzny agenta, ale informacje będą nadal znajdują się w sysjobhistory tabelamsdb bazy danych.
[ @delete_unused_schedule= ] delete_unused_schedule
Specifies whether to delete the schedules attached to this job if they are not attached to any other job.delete_unused_schedule is bit, with a default of 1.Kiedy delete_unused_schedule jest 1, harmonogramów dołączonych do tego zadanie są usuwane, jeśli nie inne zadanie odwoływać w harmonogramie.Kiedy delete_unused_schedule jest 0, harmonogramów nie są usuwane.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Zestawy wyników

None

Remarks

The @originating_server argument is reserved for internal use.

The @delete_unused_schedule argument provides backward compatibility with previous versions of SQL Server by automatically removing schedules that are not attached to any zadanie.Należy zauważyć, że ten parametr domyślne zachowanie zapewniającej zgodność ze starszymi wersjami.Aby zachować harmonogramy, które nie są dołączone do zadanie, należy podać wartość 0 as the @ delete_unused_schedule argument.

SQL Server Management Studio zapewnia to łatwe, graficzny sposób zarządzania zadaniami i jest zalecanym sposobem tworzenia i zarządzania infrastrukturą zadanie.

Ta procedura przechowywana nie można usunąć planów konserwacji, a nie można usunąć zadania, które są częścią planów konserwacji.Zamiast tego należy użyć SQL Server Management Studio Aby usunąć planów konserwacji.

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.

Członkowie sysadmin stała rola serwera mogą być wykonać sp_delete_job usunąć wszystkie zadanie.Użytkownik, który nie jest członkiem sysadmin roli serwera środka można usunąć tylko zadań należących do danego 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

Udostępnij za pośrednictwem