sp_help_jobactivity (Transact-SQL)

  • Article

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.

    ms188766.note(fr-fr,SQL.90).gifRemarque :
    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