sp_help_jobactivity (Transact-SQL)

Répertorie les informations concernant l'état d'exécution des travaux de l'Agent SQL Server.

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. L'argument job_idest de type uniqueidentifier, avec NULL comme valeur par défaut.

• [ @job_name =] 'job_name'
  Nom du travail. L'argument job_nameest de type sysname, avec NULL comme valeur par défaut.

  Remarque :
  Vous devez définir la valeur de job_id ou de job_name, mais pas les deux valeurs à la fois.

• [ @session_id = ] session_id
  Identificateur de la session pour laquelle des informations doivent être rapportées. L'argument session_id est de type int, avec NULL comme valeur par défaut.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

Cette procédure fournit une capture instantanée de l'état actuel des travaux en cours d'exécution. Les résultats renvoyés représentent des informations correspondant au moment du traitement de la requête.

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

Lorsqu'aucun argument session_id n'est fourni, la procédure répertorie des informations pour toutes les sessions.

Lorsqu'aucun argument job_name ou job_id n'est fourni, la procédure répertorie des informations pour tous les travaux.

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.

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

Ensembles de résultats

Renvoie l'ensemble 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. Une des valeurs suivantes : 1 = Exécution en fonction d'une planification. 2 = Exécution en réponse à une alerte. 3 = Exécution au démarrage. 4 = Exécution par l'utilisateur. 6 = Exécution en fonction de la planification inactive de l'UC.
queued_date	datetime	Moment où la requête a intégré une file d'attente. La valeur est 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	Identificateur 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 renvoyé de la dernière exécution du travail.
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'identification de l'opérateur notifié par net send (envoi réseau) en fin de travail.
operator_id_paged	int	Numéro d'identification de l'opérateur notifié par radiomessagerie en fin de travail.

Exemple

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