Partager via

sp_help_jobhistory (Transact-SQL)

  • Article

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

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

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 des travaux).

step_name

sysname

Nom de l'étape (NULL pour un historique des travaux).

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)