sp_delete_jobstep (Transact-SQL)
Supprime une étape d'un travail.
.gif "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_update_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
Procédures stockées système (Transact-SQL)