sp_help_jobserver (Transact-SQL)

Article
08/19/2013

Renvoie des informations sur le serveur pour un travail donné.

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

sp_help_jobserver
     { [ @job_id = ] job_id 
     | [ @job_name = ] 'job_name' }
     [ , [ @show_last_run_details = ] show_last_run_details ]

Arguments

[ @job_id= ] job_id
Numéro d'identification du travail pour lequel renvoyer des informations. job_id est de type uniqueidentifier, avec NULL comme valeur par défaut.
[ @job_name= ] 'job_name'
Nom du travail pour lequel renvoyer des informations. 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.
[ @show_last_run_details= ] show_last_run_details
Indique si les informations de la dernière exécution doivent faire partie du jeu de résultats. show_last_run_details est de type tinyint, avec 0 comme valeur par défaut. 0 ne contient pas d'informations sur la dernière exécution, contrairement à 1.

Valeurs des codes de retour

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

Jeux de résultats

Nom de colonne	Type de données	Description
server_id	int	Numéro d'identification du serveur cible.
server_name	nvarchar(30)	Nom de l'ordinateur du serveur cible.
enlist_date	datetime	Date d'inscription du serveur cible sur le serveur maître.
last_poll_date	datetime	Date à laquelle le serveur cible a interrogé pour la dernière fois le serveur maître.

Si sp_help_jobserver est exécuté alors que le paramètre show_last_run_details possède la valeur 1, le jeu de résultats comporte ces colonnes supplémentaires.

Nom de colonne	Type de données	Description
last_run_date	int	Date du début de la dernière exécution du travail sur ce serveur cible.
last_run_time	int	Heure du début de la dernière exécution du travail sur ce serveur.
last_run_duration	int	Durée du travail lors de sa dernière exécution sur ce serveur cible (en secondes).
last_outcome_message	nvarchar(1024)	Décrit le dernier résultat du travail.
last_run_outcome	int	Résultat du travail à l'issue de sa dernière exécution sur ce serveur. 0 = Échec 1 = Succès 3 = Annulation 5 = Inconnu

Autorisations

Seuls 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 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 informations sur les travaux dont ils sont propriétaires.

Exemples

L'exemple suivant renvoie des informations, dont les informations sur la dernière exécution, du travail NightlyBackups.

USE msdb ;
GO

EXEC dbo.sp_help_jobserver
    @job_name = N'NightlyBackups',
    @show_last_run_details = 1 ;
GO

Voir aussi

Référence

sp_add_jobserver (Transact-SQL)

sp_delete_jobserver (Transact-SQL)

Procédures stockées système (Transact-SQL)

Partager via