Partager via


sp_delete_jobstep (Transact-SQL)

Supprime une étape d'un travail.

Icône Lien de rubrique Conventions de la syntaxe 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_idest de type uniqueidentifier, avec NULL comme valeur par défaut.

  • [ @job_name= ] 'job_name'
    Nom du travail duquel il faut supprimer l'étape. job_nameest de type sysname, avec NULL comme valeur par défaut.

    [!REMARQUE]

    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 supprimée. step_idest 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.

[!REMARQUE]

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

Voir aussi

Référence

sp_add_jobstep (Transact-SQL)

sp_update_jobstep (Transact-SQL)

sp_help_jobstep (Transact-SQL)

Procédures stockées système (Transact-SQL)

Concepts

Afficher ou modifier les travaux