sp_help_jobs_in_schedule (Transact-SQL)
Retourne des informations sur les travaux auxquels une planification particulière est attachée.
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, sans 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, sans valeur par défaut. schedule_id ou schedule_name peut être spécifié.
Valeurs des codes de retour
0 (succès) ou 1 (échec)
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.
Ensembles de résultats
Retourne l'ensemble de résultats suivant :
| Nom de colonne | Type de données | Description |
|---|---|---|
job_id |
uniqueidentifier |
ID 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 |
ID de l'étape du travail dans laquelle l'exécution doit débuter. |
category |
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. Il peut prendre l'une des valeurs suivantes : 0 = Jamais 1 = En cas de réussite du travail 2 = En cas d'échec du travail 3 = À la fin du travail (quelle qu'en soit l'issue) |
notify_level_email |
int |
Masque de bits indiquant les conditions d'envoi d'un message électronique en fin de travail. Les valeurs possibles sont identiques à celles de 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 identiques à celles de 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 identiques à celles de notify_level_eventlog. |
notify_email_operator |
sysname |
Adresse électronique de l'opérateur à avertir. |
notify_netsend_operator |
sysname |
Nom de l'utilisateur ou de l'ordinateur utilisé pour envoyer les messages 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 identiques à celles de 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 de la prochaine exécution du travail. |
next_run_time |
int |
Heure prévue de 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 a fait l'objet de plusieurs tentatives d'exécution, 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. |
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
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)