sp_start_job (Transact-SQL)
Ordonne à l'Agent SQL Server d'exécuter immédiatement un travail.
Syntaxe
sp_start_job
{ [@job_name =] 'job_name'
| [@job_id =] job_id }
[ , [@error_flag =] error_flag]
[ , [@server_name =] 'server_name']
[ , [@step_name =] 'step_name']
[ , [@output_flag =] output_flag]
Arguments
- [ @job_name= ] 'job_name'
Nom du travail à démarrer. Spécifiez soit job_id soit job_name, mais pas les deux à la fois. job_name est de type sysname, avec NULL comme valeur par défaut.
- [ @job_id= ] job_id
Numéro d'identification du travail à démarrer. Spécifiez soit job_id soit job_name, mais pas les deux à la fois. job_id est de type uniqueidentifier, avec NULL comme valeur par défaut.
- [ @error_flag= ] error_flag
Indiqué à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
- [ @server_name= ] 'server_name'
Serveur cible sur lequel doit être lancé le travail. server_name est de type nvarchar(128), avec une valeur par défaut NULL. server_name doit être l'un des serveurs cibles visés par le travail en cours.
- [ @step_name= ] 'step_name'
Nom de l'étape où doit commencer l'exécution du travail. Ne s'applique qu'aux travaux locaux. step_name est de type sysname et prend NULL comme valeur par défaut.
- [ @output_flag= ] output_flag
Indiqué à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.
Jeux de résultats
Aucun
Notes
Cette procédure stockée se trouve dans la base de données msdb.
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.
Les membres des rôles SQLAgentUserRole et SQLAgentReaderRole peuvent lancer uniquement les travaux dont ils sont propriétaires tandis que les membres de SQLAgentOperatorRole démarrent tous les travaux locaux, y compris ceux qui appartiennent à d'autres utilisateurs. Les membres de sysadmin peuvent lancer tous les travaux locaux et multiserveurs.
Valeurs des codes renvoyés
0 (succès) ou 1 (échec)
Exemple
L'exemple suivant démarre un travail appelé Weekly Sales Data Backup.
USE msdb ;
GO
EXEC dbo.sp_start_job N'Weekly Sales Data Backup' ;
GO
Voir aussi
Référence
sp_delete_job (Transact-SQL)
sp_help_job (Transact-SQL)
sp_stop_job (Transact-SQL)
sp_update_job (Transact-SQL)
Procédures stockées système (Transact-SQL)