Partager via


sp_help_jobsteplog (Transact-SQL)

Retourne des métadonnées à propos du journal d'étapes d'un travail spécifique de l'Agent SQL Server. sp_help_jobsteplog ne retourne pas le journal proprement dit.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sp_help_jobsteplog { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }
     [ , [ @step_id = ] step_id ]
     [ , [ @step_name = ] 'step_name' ]

Arguments

  • [ @job_id =] 'job_id'
    Numéro d'identification du travail pour lequel il faut retourner des informations sur le journal d'étapes du travail. L'argument job_id est de type int, avec la valeur par défaut NULL.

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

    [!REMARQUE]

    Vous devez définir la valeur de job_id ou de job_name, mais pas les deux valeurs à la fois.

  • [ @step_id =] step_id
    Numéro d'identification de l'étape du travail. S'il n'est pas inclus, toutes les étapes du travail sont englobées. L'argument step_id est de type int et sa valeur par défaut est NULL.

  • [ @step_name =] 'step_name'
    Nom de l'étape du travail. step_name est de type sysname et sa valeur par défaut est NULL.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Ensembles de résultats

Nom de colonne

Type de données

Description

job_id

uniqueidentifier

Identificateur unique du travail.

job_name

sysname

Nom du travail.

step_id

int

Identificateur de l'étape du travail. Par exemple, s'il s'agit de la première étape du travail, la valeur de step_id est définie sur 1.

step_name

sysname

Nom de l'étape du travail.

step_uid

uniqueidentifier

Identificateur unique de l'étape du travail (généré par le système).

date_created

datetime

Date de création de l'étape.

date_modified

datetime

Date de la dernière modification de l'étape.

log_size

float

Taille du journal d'étapes du travail, en mégaoctets (Mo).

log

nvarchar(max)

Sortie du journal d'étapes du travail.

Notes

sp_help_jobsteplog se trouve dans la base de données msdb.

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 SQLAgentUserRole peuvent consulter uniquement les métadonnées du journal d'étapes du travail pour les étapes dont ils sont propriétaires.

Exemples

A. Retourne des informations sur toutes les étapes d'un travail spécifique

L'exemple ci-dessous retourne toutes les informations du journal d'étapes du travail Weekly Sales Data Backup.

USE msdb ;
GO

EXEC dbo.sp_help_jobsteplog
    @job_name = N'Weekly Sales Data Backup' ;
GO

B. Retourne des informations sur une étape spécifique du travail

L'exemple ci-dessous retourne des informations du journal d'étapes concernant la première étape du travail appelé Weekly Sales Data Backup.

USE msdb ;
GO

EXEC dbo.sp_help_jobsteplog
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1 ;
GO