sp_delete_jobstep (Transact-SQL)

  • Artigo

Aplica-se a:SQL ServerInstâ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.

Ou @job_id ou @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.

Ou @job_id ou @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.

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

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 msdb do 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 sysadmin 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

Conteúdo relacionado