Partilhar via

sp_delete_jobstep (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

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

Transact-SQL convenções de sintaxe

Sintaxe

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

Arguments

[ @job_id = ] 'job_id'

O número de identificação do trabalho do qual o passo será removido. @job_id é um identificador único, com um padrão de NULL.

Deve ser especificado @job_id ou @job_name ; Nenhum dos dois pode ser especificado.

[ @job_name = ] N'job_name'

O nome do trabalho do qual o passo será removido. @job_name é sysname, com o padrão de NULL.

Deve ser especificado @job_id ou @job_name ; Nenhum dos dois pode ser especificado.

[ @step_id = ] step_id

O número de identificação do degrau a ser removido. @step_id é int, sem padrão.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Observações

Remover um passo de trabalho atualiza automaticamente os outros passos que fazem referência ao passo eliminado.

Para mais informações sobre os passos associados a um determinado trabalho, execute sp_help_jobstep.

Observação

Chamar sp_delete_jobstep com um valor de @step_id zero apaga todos os passos do trabalho.

O SQL Server Management Studio fornece uma maneira gráfica fácil de gerenciar trabalhos e é a maneira recomendada de criar e gerenciar a infraestrutura de trabalho.

Este procedimento armazenado partilha o nome de sp_delete_jobstep com um objeto semelhante para o serviço Azure Elastic Jobs para Azure SQL Database. Para informações sobre a versão do Elastic Jobs, veja jobs.sp_delete_jobstep (Azure Elastic Jobs).

Permissions

Pode conceder EXECUTE permissões neste procedimento, mas essas permissões podem ser anuladas durante uma atualização do SQL Server.

Outros utilizadores devem receber um dos seguintes papéis fixos de base de dados SQL Server Agent na msdb base de dados:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para detalhes sobre as permissões destes papéis, consulte Funções de Base de Dados Fixas do Agente SQL Server.

Só os membros do sysadmin podem eliminar uma etapa de trabalho que pertence a outro utilizador.

Examples

O exemplo seguinte remove o passo 1 do trabalho do trabalho Weekly Sales Data Backup.

USE msdb;
GO

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

Conteúdo relacionado

  • Last updated on