sp_delete_job (Transact-SQL)

Статья
12/15/2008

Удаляет задание.

Синтаксис

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

Аргументы

[ @job_id= ] job_id
Идентификатор удаляемого задания. Аргумент job_id имеет тип uniqueidentifier и значение по умолчанию NULL.

[ @job_name= ] 'job_name'
Имя удаляемого задания. Аргумент job_name имеет тип sysname и значение по умолчанию NULL.

Примечание.

Необходимо указать либо аргумент job_id, либо аргумент job_name, но не оба аргумента одновременно.

Примечание.
Необходимо указать либо аргумент job_id, либо аргумент job_name, но не оба аргумента одновременно.

[ @originating_server= ] 'server'
Для внутреннего использования.

[ @delete_history= ] delete_history
Указывает, следует ли удалить журнал заданий. Аргумент delete_history имеет типу bit и значение по умолчанию 1. Если аргумент delete_history имеет значение 1, журнал заданий будет удален. Если аргумент delete_history имеет значение 0, журнал заданий удален не будет.

Обратите внимание, что если задание удалено, а журнал не удален, то данные журнала не будут отображаться в журнале заданий в графическом пользовательском интерфейсе агента SQL Server, но эти данные будут сохранены в таблице sysjobhistory базы данных msdb.

[ @delete_unused_schedule= ] delete_unused_schedule
Указывает, следует ли удалить расписания, связанные с этим заданием, если они не связаны ни с одним другим заданием. Аргумент delete_unused_schedule имеет тип bit и значение по умолчанию 1. Если аргумент delete_unused_schedule имеет значение 1, то расписания, связанные с этим заданием, удаляются, если они не используются ни одним другим заданием. Если аргумент delete_unused_schedule имеет значение 0, расписания не будут удалены.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Нет

Замечания

Аргумент @originating_server зарезервирован для внутреннего использования.

Аргумент @delete_unused_schedule обеспечивает обратную совместимость с прошлыми версиями SQL Server путем автоматического удаления расписаний, не связанных ни с одним заданием. Обратите внимание, что поведение этого параметра по умолчанию обеспечивает обратную совместимость. Чтобы сохранить расписания, не связанные ни с одним заданием, необходимо задать значение 0 в качестве значения аргумента @delete_unused_schedule.

Среда SQL Server Management Studio обеспечивает доступный графический способ управления заданиями и рекомендуется для создания и управления инфраструктурой заданий.

С помощью этой хранимой процедуры нельзя удалить планы обслуживания и задания, которые являются частью планов обслуживания. Для удаления планов обслуживания следует использовать среду SQL Server Management Studio.

Разрешения

По умолчанию выполнять эту хранимую процедуру могут члены фиксированной серверной роли sysadmin. Другим пользователям должна быть предоставлена одна из следующих фиксированных ролей базы данных агента SQL Server в базе данных msdb:

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Дополнительные сведения о разрешениях для этих ролей см. в разделе Фиксированные роли базы данных агента SQL Server.

Члены фиксированной серверной роли sysadmin с помощью процедуры sp_delete_job могут удалить любое задание. Пользователь, который не является членом фиксированной серверной роли sysadmin, может удалять только задания, принадлежащие этому пользователю.

Примеры

В следующем примере удаляется задание NightlyBackups.

USE msdb ;
GO

EXEC sp_delete_job
    @job_name = N'NightlyBackups' ;
GO

См. также

Справочник

sp_add_job (Transact-SQL)
sp_help_job (Transact-SQL)
sp_update_job (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)

Справка и поддержка

Получение помощи по SQL Server 2005

Поделиться через