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 = ] N'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 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 pour lequel renvoyer des informations. @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.

[ @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.
  • 1 inclut les informations de dernière exécution.

Valeurs des codes de retour

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

Jeu 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 elle est exécutée avec @show_last_run_details définie 1sur , 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éussite
3 = Annulé
5 = Inconnu

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 des informations pour les 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

Contenu connexe