sp_delete_jobstep (Transact-SQL)
Удаляет шаг задания.
Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии). |
Cинтаксические обозначения в 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 и не имеет значения по умолчанию.
Значения кода возврата
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_update_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)