sp_help_jobhistory (Transact-SQL)
Fournit des informations sur les travaux pour les serveurs dans le domaine d'administration multiserveur.
Syntaxe
sp_help_jobhistory [ [ @job_id = ] job_id ]
[ , [ @job_name = ] 'job_name' ]
[ , [ @step_id = ] step_id ]
[ , [ @sql_message_id = ] sql_message_id ]
[ , [ @sql_severity = ] sql_severity ]
[ , [ @start_run_date = ] start_run_date ]
[ , [ @end_run_date = ] end_run_date ]
[ , [ @start_run_time = ] start_run_time ]
[ , [ @end_run_time = ] end_run_time ]
[ , [ @minimum_run_duration = ] minimum_run_duration ]
[ , [ @run_status = ] run_status ]
[ , [ @minimum_retries = ] minimum_retries ]
[ , [ @oldest_first = ] oldest_first ]
[ , [ @server = ] 'server' ]
[ , [ @mode = ] 'mode' ]
Arguments
- [ @job_id= ] job_id
Numéro d'identification du travail. L'argument job_id est de type uniqueidentifier, avec NULL comme valeur par défaut.
- [ @job_name= ] 'job_name'
Nom du travail. L'argument job_name est de type sysname, avec NULL comme valeur par défaut.
- [ @step_id= ] step_id
Numéro d'identification de l'étape. L'argument step_id est de type int, avec NULL comme valeur par défaut.
- [ @sql_message_id= ] sql_message_id
Numéro d'identification du message d'erreur retourné par Microsoft SQL Server lors de l'exécution du travail. L'argument sql_message_id est de type int, avec NULL comme valeur par défaut.
- [ @sql_severity= ] sql_severity
Niveau de gravité du message d'erreur renvoyé par SQL Server lors de l'exécution du travail. L'argument sql_severity est de type int, avec NULL comme valeur par défaut.
- [ @start_run_date= ] start_run_date
Date de début de l'exécution du travail. L'argument start_run_date est de type int, avec NULL comme valeur par défaut. L'argument start_run_date doit respecter le format AAAAMMJJ, où AAAA représente les quatre chiffres de l'année, MM les deux chiffres du mois et JJ le jour.
- [ @end_run_date= ] end_run_date
Date de fin de l'exécution du travail. L'argument end_run_date est de type int, avec NULL comme valeur par défaut. L'argument end_run_datedoit respecter le format AAAAMMJJ, où AAAA représente les quatre chiffres de l'année, MM les deux chiffres du mois et JJ le jour.
- [ @start_run_time= ] start_run_time
Heure du début d'exécution du travail. L'argument start_run_time est de type int, avec NULL comme valeur par défaut. L'argument start_run_time doit respecter le format HHMMSS, où HH représente les deux chiffres de l'heure, MM les deux chiffres des minutes et SS les deux chiffres des secondes.
- [ @end_run_time= ] end_run_time
Heure de fin d'exécution du travail. L'argument end_run_time est de type int, avec NULL comme valeur par défaut. L'argument end_run_time doit respecter le format HHMMSS, où HH représente les deux chiffres de l'heure, MM les deux chiffres des minutes et SS les deux chiffres des secondes.
- [ @minimum_run_duration= ] minimum_run_duration
Durée minimale pour l'exécution du travail. L'argument minimum_run_duration est de type int, avec NULL comme valeur par défaut. L'argument minimum_run_duration doit respecter le format HHMMSS, où HH représente les deux chiffres de l'heure, MM les deux chiffres des minutes et SS les deux chiffres des secondes.
[ @run_status= ] run_status
État de l'exécution du travail. L'argument run_status est de type int et sa valeur par défaut est NULL. Il peut prendre l'une des valeurs suivantes.Valeur Description 0
Échec
1
Réussite
2
Reprise (étape uniquement)
3
Annulation
4
En cours
5
Inconnu
- [ @minimum_retries= ] minimum_retries
Nombre minimal de tentatives d'exécution d'un travail. L'argument minimum_retries est de type int, avec NULL comme valeur par défaut.
- [ @oldest_first= ] oldest_first
Indique s'il faut présenter en premier le résultat des travaux les plus anciens. L'argument oldest_first est de type int, et sa valeur par défaut 0 indique qu'il faut présenter en premier les travaux les plus récents. Avec la valeur 1, les travaux les plus anciens sont présentés en premier.
- [ @server= ] 'server'
Nom du serveur sur lequel a été exécuté le travail. L'argument server est de type nvarchar(30), avec NULL comme valeur par défaut.
- [ @mode= ] 'mode'
Indique si SQL Server doit imprimer toutes les colonnes dans le jeu de résultats (FULL) ou un résumé des colonnes. L'argument mode est de type varchar(7), avec SUMMARY comme valeur par défaut.
Valeurs des codes de retour
0 (succès) ou 1 (échec)
Jeux de résultats
La liste des colonnes dépend de la valeur de l'argument mode. Le jeu de colonnes le plus complet est présenté ci-dessous ; il est affiché lorsque mode a la valeur FULL.
| Nom de la colonne | Type de données | Description |
|---|---|---|
instance_id |
int |
Numéro d'identification de l'entrée d'historique. |
job_id |
uniqueidentifier |
Numéro d'identification du travail. |
job_name |
sysname |
Nom du travail |
step_id |
int |
Numéro d'identification de l'étape (0 pour un historique de travail). |
step_name |
sysname |
Nom de l'étape (NULL pour un historique de travail). |
sql_message_id |
int |
Pour une étape Transact-SQL, représente le numéro d'erreur Transact-SQL le plus récent affiché pendant l'exécution de la commande. |
sql_severity |
int |
Pour une étape Transact-SQL, représente le degré de gravité Transact-SQL le plus élevé obtenu pendant l'exécution de la commande. |
message |
nvarchar(1024) |
Message d'historique d'étape ou de travail. |
run_status |
int |
Résultat du travail ou de l'étape. |
run_date |
int |
Date de début d'exécution du travail ou de l'étape. |
run_time |
int |
Heure de début d'exécution du travail ou de l'étape. |
run_duration |
int |
Durée, au format HHMMSS, de l'exécution du travail ou de l'étape. |
operator_emailed |
nvarchar(20) |
Opérateur qui a reçu un courrier électronique concernant ce travail (NULL pour un historique d'étape). |
operator_netsent |
nvarchar(20) |
Opérateur qui a reçu un message réseau concernant ce travail (NULL pour un historique d'étape). |
operator_paged |
nvarchar(20) |
Opérateur qui a reçu un message par radiomessagerie concernant ce travail (NULL pour un historique d'étape). |
retries_attempted |
int |
Nombre de reprises de l'étape (0 pour un historique d'étape). |
server |
nvarchar(30) |
Serveur sur lequel est exécutée l'étape ou le travail. Toujours (local). |
Notes
sp_help_jobhistory retourne un rapport contenant l'historique des travaux planifiés spécifiés. Si aucun paramètre n'est précisé, le rapport contient l'historique de tous les travaux planifiés.
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 de base de données SQLAgentUserRole peuvent uniquement consulter l'historique des travaux dont ils sont propriétaires.
Exemples
A. Affichage de toutes les informations d'un travail
L'exemple ci-dessous répertorie toutes les informations du travail NightlyBackups.
USE msdb ;
GO
EXEC dbo.sp_help_jobhistory
@job_name = N'NightlyBackups' ;
GO
B. Affichage des informations sur les travaux répondant à certaines conditions
L'exemple ci-dessous imprime toutes les colonnes et toutes les informations de tous les travaux et toutes les étapes de travail qui ont échoué avec un message d'erreur 50100 (message d'erreur personnalisé) et un degré de gravité égal à 20.
USE msdb
GO
EXEC dbo.sp_help_jobhistory
@sql_message_id = 50100,
@sql_severity = 20,
@run_status = 0,
@mode = N'FULL' ;
GO
Voir aussi
Référence
sp_purge_jobhistory (Transact-SQL)
Procédures stockées système (Transact-SQL)