sp_help_jobs_in_schedule (Transact-SQL)
Retourne des informations sur les travaux auxquels une planification particulière est attachée.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_help_jobs_in_schedule
[ @schedule_name = ] 'schedule_name' ,
[ @schedule_id = ] schedule_id
Arguments
[ @schedule_id = ] schedule_id
Identificateur de la planification pour laquelle répertorier des informations. schedule_id est de type int et n'a pas de valeur par défaut. schedule_id ou schedule_name peut être spécifié.[ @schedule_name = ] 'schedule_name'
Nom de la planification pour laquelle répertorier des informations. schedule_name est de type sysname et n'a pas de valeur par défaut. schedule_id ou schedule_name peut être spécifié.
Valeurs des codes de retour
0 (succès) ou 1 (échec)
Ensembles de résultats
Retourne le jeu de résultats suivant :
Nom de colonne |
Type de données |
Description |
---|---|---|
job_id |
uniqueidentifier |
Identificateur unique du travail. |
originating_server |
nvarchar(30) |
Nom du serveur d'origine du travail |
name |
sysname |
Nom du travail |
enabled |
tinyint |
Indique si le travail est activé pour être exécuté. |
description |
nvarchar(512) |
Description du travail. |
start_step_id |
int |
Identificateur de l'étape du travail à partir de laquelle l'exécution doit débuter. |
catégorie |
sysname |
Catégorie du travail. |
owner |
sysname |
Propriétaire du travail. |
notify_level_eventlog |
int |
Masque binaire indiquant les circonstances entraînant la consignation d'une notification d'événement dans le journal des applications Microsoft Windows. Peut prendre l'une des valeurs suivantes : 0 = Jamais 1 = En cas de succès du travail 2 = En cas d'échec du travail 3 = À la fin du travail (quelle que soit l'issue du travail) |
notify_level_email |
int |
Masque de bits indiquant les conditions d'envoi d'un message électronique en fin de travail. Les valeurs possibles sont les mêmes que pour notify_level_eventlog. |
notify_level_netsend |
int |
Masque de bits précisant les conditions d'envoi d'un message réseau en fin de travail. Les valeurs possibles sont les mêmes que pour notify_level_eventlog. |
notify_level_page |
int |
Masque de bits indiquant les conditions d'envoi d'une page en fin de travail. Les valeurs possibles sont les mêmes que pour notify_level_eventlog. |
notify_email_operator |
sysname |
Nom d'adresse électronique de l'opérateur à avertir |
notify_netsend_operator |
sysname |
Nom de l'utilisateur ou de l'ordinateur utilisé pour envoyer les messages sur le réseau. |
notify_page_operator |
sysname |
Nom de l'utilisateur ou de l'ordinateur utilisé pour envoyer une page. |
delete_level |
int |
Masque de bits indiquant les conditions de suppression du travail en fin de travail. Les valeurs possibles sont les mêmes que pour notify_level_eventlog. |
date_created |
datetime |
Date de création du travail |
date_modified |
datetime |
Date de dernière modification du travail |
version_number |
int |
Version du travail (mise à jour automatique à chaque modification). |
last_run_date |
int |
Date du début de la dernière exécution du travail. |
last_run_time |
int |
Heure du début de la dernière exécution du travail. |
last_run_outcome |
int |
Résultat du travail lors de sa dernière exécution : 0 = Échec 1 = Succès 3 = Annulation 5 = Inconnu |
next_run_date |
int |
Date prévue pour la prochaine exécution du travail. |
next_run_time |
int |
Heure prévue pour la prochaine exécution du travail. |
next_run_schedule_id |
int |
Numéro d'identification de la prochaine exécution planifiée. |
current_execution_status |
int |
État de l'exécution en cours. |
current_execution_step |
sysname |
Étape d'exécution du travail en cours. |
current_retry_attempt |
int |
Si le travail est en cours d'exécution et que l'étape est effectuée plusieurs fois, ce paramètre correspond à la tentative en cours. |
has_step |
int |
Nombre d'étapes du travail. |
has_schedule |
int |
Nombre de planifications d'un travail. |
has_target |
int |
Nombre de serveurs cibles d'un travail. |
type |
int |
Type du travail : 1 = Travail local. 2 = Travail multiserveur. 0 = Travail sans serveur cible. |
Notes
Cette procédure affiche des informations sur les travaux attachés à la planification spécifiée.
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 du rôle SQLAgentUserRole peuvent consulter uniquement l'état des travaux dont ils sont propriétaires.
Exemples
L'exemple suivant affiche les travaux attachés à la planification NightlyJobs.
USE msdb ;
GO
EXEC sp_help_jobs_in_schedule
@schedule_name = N'NightlyJobs' ;
GO
Voir aussi
Référence
Procédures stockées de l'Agent SQL Server (Transact-SQL)
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)