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