sp_help_jobserver (Transact-SQL)

  • Article

S’applique à :SQL Server

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

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 retourner des informations. job_id est uniqueidentifier, avec une valeur par défaut NULL.

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

Notes

Les job_id ou les job_name doivent être spécifiés, mais les deux ne peuvent pas être spécifiés.

[ @show_last_run_details = ] show_last_run_details Indique si les informations d’exécution de la dernière exécution font partie du jeu de résultats. show_last_run_details est tinyint, avec une valeur par défaut de 0. 0 n’inclut pas les informations de dernière exécution, et 1 .

Codet de retour

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

Jeux de résultats

Nom de la 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é avec show_last_run_details défini sur 1, le jeu de résultats comporte ces colonnes supplémentaires.

Nom de la 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 = Réussi

3 = Annulé

5 = Inconnu

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 informations relatives aux travaux qu’ils possèdent.

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

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