• Статья

sp_delete_job (Transact-SQL)

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

Значок ссылки на разделСинтаксические обозначения в 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 ]

Аргументы

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

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

    ПримечаниеПримечание

    Необходимо указать либо аргумент 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