sp_help_jobactivity (Transact-SQL)

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

Icône Lien de rubrique Conventions de la syntaxe Transact-SQL

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

  • [ @job_name =] 'job_name'
    Nom du travail. 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. session_id est de type int, avec NULL comme valeur par défaut.

Valeurs des codes 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. 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

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 échec

1 = Succès

3 = Annulation

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'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.

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.

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.

Lorsque aucun session_id n'est fourni, répertorie les informations sur la session la plus récente.

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

Autorisations

Par défaut, seuls 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 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.

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

Référence

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