Share via

sp_help_jobs_in_schedule (Transact-SQL)

  • Article

S’applique à :SQL Server

Retourne des informations sur les travaux auxquels une planification particulière est attachée.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_help_jobs_in_schedule
    [ [ @schedule_name = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
[ ; ]

Arguments

[ @schedule_id = ] schedule_id

Identificateur de la planification pour laquelle répertorier des informations. @schedule_id est int, avec la valeur par défaut NULL.

Vous pouvez spécifier @schedule_id ou @schedule_name .

[ @schedule_name = ] N’schedule_name'

Nom de la planification pour laquelle répertorier des informations. @schedule_name est sysname, avec la valeur par défaut NULL.

Vous pouvez spécifier @schedule_id ou @schedule_name .

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
job_id uniqueidentifier ID unique du travail.
originating_server nvarchar(30) Nom du serveur d'origine du travail
name sysname Nom du travail.
enabled tinyint Indique si le travail est activé, afin qu’il puisse s’exécuter.
description nvarchar(512) Description du travail.
start_step_id int Identificateur de l'étape du travail à partir de laquelle l'exécution doit débuter.
category sysname Catégorie de travail.
owner sysname Propriétaire du travail.
notify_level_eventlog int Masque binaire indiquant les circonstances entraînant la consignation d'une notification d'événement dans le journal des applications Microsoft Windows. Peut prendre l'une des valeurs suivantes :

0 = Jamais
1 = Lorsqu’un travail réussit
2 = En cas d’échec du travail
3 = Chaque fois que le travail se termine (quel que soit le résultat du travail)
notify_level_email int Masque de bits indiquant les conditions d'envoi d'un message électronique en fin de travail. Les valeurs possibles sont les mêmes que pour notify_level_eventlog.
notify_level_netsend int Masque de bits précisant les conditions d'envoi d'un message réseau en fin de travail. Les valeurs possibles sont les mêmes que pour notify_level_eventlog.
notify_level_page int Masque de bits indiquant les conditions d'envoi d'une page en fin de travail. Les valeurs possibles sont les mêmes que pour notify_level_eventlog.
notify_email_operator sysname Nom d'adresse électronique de l'opérateur à avertir.
notify_netsend_operator sysname Nom de l'utilisateur ou de l'ordinateur utilisé pour envoyer les messages sur le réseau.
notify_page_operator sysname Nom de l'utilisateur ou de l'ordinateur utilisé pour envoyer une page.
delete_level int Masque de bits indiquant les conditions de suppression du travail en fin de travail. Les valeurs possibles sont les mêmes que pour notify_level_eventlog.
date_created datetime Date de création du travail.
date_modified datetime Date de dernière modification du travail.
version_number int Version du travail (mise à jour automatique à chaque modification).
last_run_date int Date du début de la dernière exécution du travail.
last_run_time int Heure du début de la dernière exécution du travail.
last_run_outcome int Résultat du travail lors de sa dernière exécution :

0 = Échec
1 = Réussite
3 = Annulé
5 = Inconnu
next_run_date int Date prévue pour la prochaine exécution du travail.
next_run_time int Heure prévue pour la prochaine exécution du travail.
next_run_schedule_id int Numéro d'identification de la prochaine exécution planifiée.
current_execution_status int État d’exécution actuel.
current_execution_step sysname Étape d'exécution du travail en cours.
current_retry_attempt int Si le travail est en cours d’exécution et que l’étape a été retentée, cette valeur est la tentative de nouvelle tentative actuelle.
has_step int Nombre d'étapes du travail.
has_schedule int Nombre de planifications d'un travail.
has_target int Nombre de serveurs cibles d'un travail.
type int Type du travail :

1 = Travail local.
2 = Travail multiserveur.
0 = Le travail n’a pas de serveurs cibles.

Notes

Cette procédure affiche des informations sur les travaux attachés à la planification spécifiée.

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.

Les membres de SQLAgentUserRole ne peuvent afficher que l’état des travaux qu’ils possèdent.

Exemples

L'exemple suivant affiche les travaux attachés à la planification NightlyJobs.

USE msdb;
GO

EXEC sp_help_jobs_in_schedule
    @schedule_name = N'NightlyJobs';
GO

Contenu connexe