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


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.

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

    Должен быть указан либо аргумент 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