sp_delete_jobstep (Transact-SQL)

Область применения: SQL Server Управляемый экземпляр SQL Azure

Удаляет шаг задания из задания в службе агент SQL Server.

Соглашения о синтаксисе Transact-SQL

Синтаксис

sp_delete_jobstep
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    , [ @step_id = ] step_id
[ ; ]

Аргументы

[ @job_id = ] 'job_id'

Идентификационный номер задания, из которого удаляется этап. @job_id является уникальным идентификатором по умолчаниюNULL.

Необходимо указать либо @job_id, либо @job_name; их нельзя указать.

[ @job_name = ] N'job_name'

Имя задания, из которого удаляется этап. @job_name — sysname с значением по умолчаниюNULL.

Необходимо указать либо @job_id, либо @job_name; их нельзя указать.

[ @step_id = ] step_id

Идентификатор удаляемого этапа задания. @step_id не используется без значения по умолчанию.

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

0 (успешно) или 1 (сбой).

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

Нет.

Замечания

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

Дополнительные сведения о шагах, связанных с определенным заданием, выполните команду sp_help_jobstep.

Примечание.

Вызов sp_delete_jobstep с @step_id значением нуля удаляет все шаги задания для задания.

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

Эта хранимая процедура использует имя аналогичного sp_delete_jobstep объекта для службы заданий Elastic Azure для База данных SQL Azure. Сведения о версии эластичных заданий см. в разделе jobs.sp_delete_jobstep (Задания эластичных баз данных Azure).

Разрешения

Эта хранимая процедура принадлежит роли db_owner . Вы можете предоставить EXECUTE разрешения для любого пользователя, но эти разрешения могут быть переопределены во время обновления SQL Server.

Другим пользователям необходимо предоставить одну из следующих агент 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