sp_help_jobsteplog (Transact-SQL)

  • Article

S’applique à :SQL Server

Retourne des métadonnées relatives à un journal d’étape de travail SQL Server Agent spécifique. sp_help_jobsteplog ne retourne pas le journal réel.

Conventions de la syntaxe 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 retourner les informations du journal de l’étape de travail. job_id est int, avec la valeur par défaut NULL.

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

Notes

Vous devez spécifier job_id ou job_name , mais les deux ne peuvent pas être spécifiés.

[ @step_id = ] step_id Numéro d’identification de l’étape dans le travail. S'il n'est pas inclus, toutes les étapes du travail sont englobées. step_id est int, avec la valeur par défaut NULL.

[ @step_name = ] 'step_name' Nom de l’étape dans le travail. step_name est sysname, avec la valeur par défaut NULL.

Codet de retour

0 (réussite) ou 1 (échec)

Jeux de résultats

Nom de la 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, si l’étape est la première étape du travail, son step_id est 1.
step_name sysname Nom de l’étape dans le 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.

Remarques

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

Autorisations

Par défaut, les membres du rôle 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 suivants de SQL Server Agent 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 de SQLAgentUserRole peuvent uniquement afficher les métadonnées du journal des étapes de travail pour les étapes de travail dont ils sont propriétaires.

Exemples

R. 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

Voir aussi

sp_add_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_delete_jobsteplog (Transact-SQL)
Procédures stockées de l'Agent SQL Server (Transact-SQL)