sp_help_jobserver (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe de 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 et sa valeur par défaut est NULL.

  • [ @job_name= ] 'job_name'
    Nom du travail pour lequel renvoyer des informations. job_name est de type sysname et sa valeur par défaut est NULL.

    Notes

    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, et sa valeur par défaut est 0. 0 ne contient pas d'informations sur la dernière exécution, contrairement à 1.

Valeurs des codes de retour

0 (succès) 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 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 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