Partager via


sp_help_jobhistory (Transact-SQL)

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

Icône Lien de rubriqueConventions 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. 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