sp_help_jobactivity (Transact-SQL)

  • Article

S'applique à : SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_help_jobactivity
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @session_id = ] session_id ]
[ ; ]

Arguments

[ @job_id = ] 'job_id'

Numéro d’identification du travail. @job_id est uniqueidentifier, avec la valeur par défaut NULL.

Vous devez spécifier @job_id ou @job_name , mais les deux ne peuvent pas être spécifiées.

[ @job_name = ] N’job_name'

Nom du travail. @job_name est sysname, avec la valeur par défaut NULL.

Vous devez spécifier @job_id ou @job_name , mais les deux ne peuvent pas être spécifiées.

[ @session_id = ] session_id

ID de session pour signaler des informations sur. @session_id est int, avec la valeur par défaut NULL.

Valeurs des codes de retour

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

Jeu 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 selon la planification d’inactivité du processeur
queued_date datetime Spécifie quand la demande a été mise en 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 = Échec de l’erreur
1 = Réussite
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 averti via l’envoi net à l’achèvement du travail.
operator_id_paged int Numéro d'identification de l'opérateur notifié par radiomessagerie en fin de travail.

Notes

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 relatives à la session la plus récente.

Lorsqu’aucun @job_name ou @job_id n’est fourni, répertorie les informations de tous les travaux.

autorisations

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations peuvent être remplacées lors d’une mise à niveau de SQL Server.

D’autres utilisateurs doivent disposer de l’un des rôles de base de données fixes SQL Server Agent suivants dans la msdb base de données :

  • 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

Contenu connexe