sp_delete_jobstep (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..gif "ms177582.note(ru-ru,SQL.90).gif")
Примечание.Должен быть указан либо аргумент 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_add_jobstep (Transact-SQL)
sp_update_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
Системные хранимые процедуры (Transact-SQL)