sp_help_jobhistory (Transact-SQL)

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.

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

USE msdb ;
GO

EXEC dbo.sp_help_jobhistory 
    @job_name = N'NightlyBackups' ;
GO

B. Affichage des informations sur les travaux répondant à certaines conditions

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