sp_delete_jobstep (Transact-SQL)

Supprime une étape d'un travail.

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.

  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 à 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)

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.

Ensembles de résultats

Aucun

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)

Autres ressources

Affichage et modification des travaux

Aide et Informations

Assistance sur SQL Server 2005