Compartilhar via


sp_delete_jobstep (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Remove uma etapa de trabalho de um trabalho no serviço SQL Server Agent.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@job_id [ = ] 'job_id'

O número de identificação do trabalho no qual a etapa será removida. @job_id é uniqueidentifier, com um padrão de NULL.

Tanto @job_id quanto @job_name devem ser especificados; ambos não podem ser especificados.

@job_name [ = ] N'job_name'

O nome do trabalho no qual a etapa será removida. @job_name é sysname, com um padrão de NULL.

Tanto @job_id quanto @job_name devem ser especificados; ambos não podem ser especificados.

@step_id [ = ] step_id

O número de identificação da etapa que está sendo removida. @step_id é int, sem padrão.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Nenhum.

Comentários

A remoção de uma etapa de trabalho atualiza automaticamente as outras etapas de trabalho que fazem referência à etapa excluída.

Para obter mais informações sobre as etapas associadas a um trabalho específico, execute sp_help_jobstep.

Observação

Chamar sp_delete_jobstep com um valor @step_id de zero exclui todas as etapas do trabalho.

O SQL Server Management Studio fornece um modo gráfico fácil de gerenciar trabalhos e é o modo recomendado de criar e gerenciar a infra-estrutura de trabalho.

Esse procedimento armazenado compartilha o nome de sp_delete_jobstep com um objeto semelhante para o serviço de Trabalhos Elásticos do Azure para Banco de Dados SQL do Azure. Para obter informações sobre a versão dos trabalhos elásticos, consulte jobs.sp_delete_jobstep (Trabalhos Elásticos do Azure).

Permissões

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Outros usuários devem receber uma das seguintes funções de banco de dados fixas do msdb SQL Server Agent no banco de dados:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

Somente membros do administrador de sistema podem excluir uma etapa de trabalho que pertence a outro usuário.

Exemplos

O exemplo a seguir remove a etapa de trabalho 1 do trabalho Weekly Sales Data Backup.

USE msdb;
GO

EXEC dbo.sp_delete_jobstep
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1;
GO