sp_delete_jobstep (Transact-SQL)

Статья
06/18/2013

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

Значок ссылки на раздел Синтаксические обозначения Transact-SQL

Синтаксис

sp_delete_jobstep { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } , 
     [ @step_id = ] step_id

Аргументы

[ @job_id= ] job_id
Идентификационный номер задания, из которого удаляется этап. Аргумент job_id имеет тип uniqueidentifier и значение по умолчанию NULL.
[ @job_name= ] 'job_name'
Имя задания, из которого удаляется этап. Аргумент job_nameимеет тип sysname и значение по умолчанию NULL.

Примечание

Должен быть указан либо аргумент job_id, либо аргумент job_name, но не оба.
[ @step_id= ] step_id
Идентификатор удаляемого этапа задания. Аргумент step_idимеет тип int и не имеет значения по умолчанию.

Примечание
Должен быть указан либо аргумент job_id, либо аргумент job_name, но не оба.

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

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

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

Нет

Замечания

При удалении шага задания автоматически обновляются и другие этапы, ссылающиеся на удаляемый шаг.

Дополнительные сведения об этапах, связанных с конкретными заданиями, можно получить, выполнив процедуру sp_help_jobstep.

Примечание
Выполнение процедуры sp_delete_jobstep с аргументом step_id, имеющим значение 0, удаляет все шаги данного задания.

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

Разрешения

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

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole.

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

Только член роли sysadmin может удалить шаг задания, владельцем которого является другой пользователь.

Примеры

В следующем примере производится удаление шага 1 из задания Weekly Sales Data Backup.

USE msdb ;
GO

EXEC dbo.sp_delete_jobstep
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1 ;
GO

См. также

Справочник

sp_add_jobstep (Transact-SQL)

sp_update_jobstep (Transact-SQL)

sp_help_jobstep (Transact-SQL)

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

Основные понятия

Просмотр или изменение заданий

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