sp_help_jobhistory (Transact-SQL)

Fournit des informations sur les travaux pour les serveurs dans le domaine d'administration multiserveur.

Conventions de la syntaxe de 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. job_id est de type uniqueidentifier, avec NULL comme valeur par défaut.

• [ @job_name= ] 'job_name'
  Nom du travail. job_name est de type sysname, avec NULL comme valeur par défaut.

• [ @step_id= ] step_id
  Numéro d'identification de l'étape. 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. 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. 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. start_run_dateest de type int, avec NULL comme valeur par défaut. 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. end_run_date est de type int, avec NULL comme valeur par défaut. 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. start_run_time est de type int, avec NULL comme valeur par défaut. start_run_timedoit 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. end_run_time est de type int, avec NULL comme valeur par défaut. end_run_timedoit 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. minimum_run_duration est de type int, avec NULL comme valeur par défaut. minimum_run_durationdoit 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. run_status est de type int, avec NULL comme valeur par défaut et peut prendre l'une de ces valeurs.

  Valeur	Description
  0	Échec
  1	Opération réussie
  2	Reprise (étape uniquement)
  3	Opération annulée
  4	En cours
  5	Inconnue

• [ @minimum_retries= ] minimum_retries
  Nombre minimal de tentatives d'exécution d'un travail. 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. oldest_first est de type int, avec 0 comme valeur par défaut, qui présente 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 le travail a été exécuté. server est de type nvarchar(30), avec NULL comme valeur par défaut.

• [ @mode= ] 'mode'
  Indique si SQL Server doit imprimer toutes les colonnes du jeu de résultats (FULL) ou un résumé des colonnes. 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

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)