sp_help_jobactivity (Transact-SQL)

Article
11/07/2023

S’applique à :SQL Server

Répertorie des informations sur l’état d’exécution de SQL Server Agent travaux.

Syntaxe

  
sp_help_jobactivity { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }  
     [ , [ @session_id = ] session_id ]

Arguments

[ @job_id = ] job_id Numéro d’identification du travail. job_idest uniqueidentifier, avec une valeur par défaut NULL.

[ @job_name = ] 'job_name' Nom du travail. job_nameest sysname, avec la valeur null par défaut.

Notes

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

[ @session_id = ] session_id ID de session pour laquelle rapporter des informations. session_id est int, avec la valeur NULL par défaut.

Codet de retour

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

Jeux de résultats

Retourne le jeu de résultats suivant :

Nom de la colonne	Type de données	Description
session_id	int	Numéro d'identification de la session de l'Agent.
job_id	uniqueidentifier	Identificateur du travail.
job_name	sysname	Nom du travail.
run_requested_date	datetime	Moment auquel le travail devait s'exécuter.
run_requested_source	sysname	Source de la requête pour exécuter le travail. Valeurs possibles : 1 = Exécuter selon une planification 2 = Exécuter en réponse à une alerte 3 = Exécuter au démarrage 4 = Exécuter par l’utilisateur 6 = Exécuter sur la planification d’inactivité du processeur
queued_date	datetime	Moment où la requête a intégré une file d'attente. NULL si le travail a été exécuté directement.
start_execution_date	datetime	Moment où le travail a été attribué à un thread exécutable.
last_executed_step_id	int	ID de l'étape du travail exécutée en dernier lieu.
last_exectued_step_date	datetime	Heure à laquelle l'étape du travail exécutée en dernier lieu a démarré son exécution.
stop_execution_date	datetime	Heure à laquelle l'exécution du travail s'est terminée.
next_scheduled_run_date	datetime	Date et heure prévues pour la prochaine exécution du travail.
job_history_id	int	Identificateur de l'historique des travaux dans la table d'historique des travaux.
message	nvarchar(1024)	Message produit lors de la dernière exécution du travail.
run_status	int	État retourné de la dernière exécution du travail : 0 = Erreur ayant échoué 1 = Réussi 3 = Annulé 5 = État inconnu
operator_id_emailed	int	Numéro d'identification de l'opérateur notifié par courrier électronique en fin de travail.
operator_id_netsent	int	Numéro d’ID de l’opérateur notifié via net send à la fin de la tâche.
operator_id_paged	int	Numéro d'identification de l'opérateur notifié par radiomessagerie en fin de travail.

Remarques

Cette procédure fournit un instantané de l'état actuel des travaux. Les résultats renvoyés représentent des informations correspondant au moment du traitement de la requête.

SQL Server Agent crée un ID de session chaque fois que le service Agent démarre. L’ID de session est stocké dans la table msdb.dbo.syssessions.

Lorsqu’aucune session_id n’est fournie, répertorie les informations sur la session la plus récente.

Lorsqu’aucune job_name ou job_id n’est fournie, répertorie les informations pour tous les travaux.

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.

Seuls les membres de sysadmin peuvent afficher l’activité pour les travaux appartenant à d’autres utilisateurs.

Exemples

L'exemple suivant répertorie les activités de tous les travaux que l'utilisateur actuel a l'autorisation d'afficher.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobactivity ;  
GO

Voir aussi

Procédures stockées de l'Agent SQL Server (Transact-SQL)