Partager via


sp_delete_jobstep (Transact-SQL)

S’applique à : SQL Server Azure SQL Managed Instance

Supprime une étape de travail d’un travail dans le service SQL Server Agent.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_delete_jobstep
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'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 uniqueidentifier, avec la valeur par défaut NULL.

@job_id ou @job_name doivent être spécifiés ; les deux ne peuvent pas être spécifiés.

[ @job_name = ] N’job_name'

Nom du travail duquel il faut supprimer l'étape. @job_name est sysname, avec la valeur par défaut NULL.

@job_id ou @job_name doivent être spécifiés ; les deux ne peuvent pas être spécifiés.

[ @step_id = ] step_id

Numéro d'identification de l'étape supprimée. @step_id est int, sans valeur par défaut.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Jeu de résultats

Aucune.

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

L’appel sp_delete_jobstep avec une valeur @step_id de zéro supprime toutes les étapes du travail.

SQL Server Management Studio offre un moyen simple et graphique de gérer les tâches, et est recommandé pour la création et la gestion de l'infrastructure de travail.

Cette procédure stockée partage le nom d’un sp_delete_jobstep objet similaire pour le service Travaux élastiques Azure pour Azure SQL Database. Pour plus d’informations sur la version des travaux élastiques, consultez jobs.sp_delete_jobstep (Travaux élastiques Azure).

autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

D’autres utilisateurs doivent disposer de l’un des rôles de base de données fixes SQL Server Agent suivants dans la msdb base de données :

  • 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 de 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