• Article

sp_delete_jobstep (Transact-SQL)

Supprime une étape d'un travail.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @job_id= ] job_id
    Numéro d'identification du travail duquel il faut supprimer l'étape. job_id est de type uniqueidentifier et sa valeur par défaut est NULL.

  • [ @job_name= ] 'job_name'
    Nom du travail duquel il faut supprimer l'étape. job_name est de type sysname et sa valeur par défaut est NULL.

    Notes

    Vous pouvez définir la valeur de job_id ou de job_name, mais pas les deux valeurs à la fois.

  • [ @step_id= ] step_id
    Numéro d'identification de l'étape à supprimer. step_id est de type int et n'a pas de valeur par défaut.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Ensembles de résultats

Aucun

Notes

Si vous supprimez une étape de travail, les autres étapes contenant une référence à l'étape supprimée sont automatiquement mises à jour.

Pour plus d'informations sur les étapes associées à un travail particulier, exécutez sp_help_jobstep.

Notes

Lorsque vous appelez sp_delete_jobstep en affectant la valeur 0 à step_id, toutes les étapes du travail sont supprimées.

Microsoft SQL Server Management Studio est un outil simple, basé sur une interface graphique, qui permet de gérer les travaux. Son utilisation est recommandée pour créer et gérer l'infrastructure des travaux.

Autorisations

Seuls les membres du rôle de serveur fixe sysadmin peuvent exécuter cette procédure stockée. Les autres utilisateurs doivent disposer de l'un des rôles de base de données fixes SQL Server Agent suivants dans la base de données msdb.

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Pour en savoir plus sur les autorisations de ces rôles, consultez Rôles de base de données fixes de l'Agent SQL Server.

Seuls les membres du rôle sysadmin peuvent supprimer une étape de travail appartenant à un autre utilisateur.

Exemples

L'exemple suivant supprime l'étape 1 du travail Weekly Sales Data Backup.

USE msdb ;
GO

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