Compartilhar via


sp_delete_jobstep (Transact-SQL)

Remove uma etapa de trabalho de um trabalho.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_delete_jobstep { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } , 
     [ @step_id = ] step_id 

Argumentos

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

  • [ @job_name= ] 'job_name'
    O nome do trabalho do qual a etapa será removida. job_nameé sysname, com um padrão NULL.

    ObservaçãoObservação

    É necessário especificar a job_id ou o job_name, mas não é possível especificar ambos ao mesmo tempo.

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

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos 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çãoObservação

Chamar sp_delete_jobstep com um valor de step_id igual a zero exclui todas as etapas de trabalho relativas ao trabalho.

O Microsoft SQL Server Management Studio fornece uma forma fácil e gráfica para gerenciar trabalhos. Além disso, ele é recomendado para criar e gerenciar a infra-estrutura do trabalho.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários uma das seguintes funções de banco de dados fixas do SQL Server Agent no banco de dados msdb:

  • 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 os membros de sysadmin podem excluir uma etapa de trabalho pertencente 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