Share via

sp_help_jobsteplog (Transact-SQL)

  • Article

S’applique à :SQL Server

Retourne les 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 = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'step_name' ]
[ ; ]

Arguments

[ @job_id = ] 'job_id'

Numéro d'identification du travail pour lequel renvoyer des informations du journal d'étapes de travail. @job_id est uniqueidentifier, avec la valeur par défaut NULL.

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

[ @job_name = ] N’job_name'

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

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

[ @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. @step_id est int, avec la valeur par défaut NULL.

[ @step_name = ] N’step_name'

Nom de l'étape du travail. @step_name est sysname, avec la valeur par défaut NULL.

Valeurs des codes de retour

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

Jeu 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, sa valeur step_id est 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 des é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 msdb base de données.

Autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

D’autres utilisateurs doivent disposer de l’un des rôles de base de données fixes SQL Server Agent suivants dans la msdb base de données :

  • 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 qu’ils possèdent.

Exemples

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

L’exemple suivant retourne toutes les informations du journal des étapes du travail, pour le travail nommé 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 suivant retourne les informations du journal des étapes du travail, à propos de la première étape du travail nommé Weekly Sales Data Backup.

USE msdb;
GO

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

Contenu connexe