sp_help_jobs_in_schedule (Transact-SQL)

Article
11/07/2023

S’applique à :SQL Server

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

Syntaxe

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

Arguments

[ @schedule_id = ] schedule_id Identificateur de la planification pour laquelle répertorier les informations. schedule_id est int, sans valeur par défaut. Vous pouvez spécifier schedule_id ou schedule_name .

[ @schedule_name = ] 'schedule_name' Nom de la planification pour laquelle répertorier les informations. schedule_name est sysname, sans valeur par défaut. Vous pouvez spécifier schedule_id ou schedule_name .

Codet 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
job_id	uniqueidentifier	ID unique du travail.
originating_server	nvarchar(30)	Nom du serveur d'origine du travail
name	sysname	Nom du travail.
activé	tinyint	Indique si le travail est activé pour être exécuté.
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.
propriétaire	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 = Quand un travail réussit 2 = En cas d’échec du travail 3 = Chaque fois que le travail est terminé (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éussi 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 est effectuée plusieurs fois, ce paramètre correspond à la tentative en cours.
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.

Remarques

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

Autorisations

Par défaut, 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 suivants de SQL Server Agent 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.

Les membres de SQLAgentUserRole peuvent uniquement afficher 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

Voir aussi

Procédures stockées de l'Agent SQL Server (Transact-SQL)
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)