sp_help_jobserver (Transact-SQL)

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

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.

  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, 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

Voir aussi

Référence

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

Aide et Informations

Assistance sur SQL Server 2005