sp_help_jobserver (Transact-SQL)
Renvoie des informations sur le serveur pour un travail donné.
.gif "Icône Lien de rubrique")
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