Share via


jobs.sp_delete_jobstep (Azure Elastic Jobs) (Transact-SQL)

Aplica-se a:Banco de Dados SQL do Azure

Remove uma etapa de trabalho existente de um trabalho existente no serviço Azure Elastic Jobs para Banco de Dados SQL do Azure.

Esse procedimento armazenado compartilha o nome de sp_delete_jobstep com um objeto semelhante no SQL Server para o serviço SQL Server Agent. Para obter informações sobre a versão do SQL Server Agent, consulte sp_delete_jobstep (Transact-SQL).

Convenções de sintaxe de Transact-SQL

Sintaxe

[jobs].sp_delete_jobstep [ @job_name = ] 'job_name'
     [ , [ @step_id = ] step_id ]
     [ , [ @step_name = ] 'step_name' ]
     [ , [ @job_version = ] job_version OUTPUT ]

Argumentos

@job_name

O nome do trabalho do qual remover a etapa. job_name é nvarchar(128), sem padrão.

@step_id

O número de identificação da etapa de trabalho a ser excluída. Devem ser especificados step_id ou step_name . step_id é um int.

@step_name

O nome da etapa a ser excluída. Devem ser especificados step_id ou step_name . step_name é Nvarchar(128).

@job_version SAÍDA

Parâmetro de saída atribuído ao novo número de versão do trabalho. job_version é int.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

Para remover um trabalho inteiro, use jobs.sp_delete_job (Azure Elastic Jobs) (Transact-SQL).

Quaisquer execuções em andamento do trabalho não são afetadas.

As outras etapas de trabalho são renumeradas automaticamente para preencher a lacuna deixada pela etapa de trabalho excluída.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Somente os membros da função sysadmin podem usar esse procedimento armazenado para editar os atributos dos trabalhos pertencentes a outros usuários.