Partager via


sp_help_jobs_in_schedule (Transact-SQL)

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

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

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 des informations. schedule_id est de type int, sans valeur par défaut. schedule_id ou schedule_name peut être spécifié.

  • [ @schedule_name = ] 'schedule_name'
    Nom de la planification pour laquelle répertorier des informations. schedule_name est de type sysname, sans valeur par défaut. schedule_id ou schedule_name peut être spécifié.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Ensembles de résultats

Retourne l'ensemble de résultats suivant :

Nom de 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é pour être exécuté.

description

nvarchar(512)

Description du travail.

start_step_id

int

ID de l'étape du travail dans laquelle l'exécution doit débuter.

category

sysname

Catégorie du 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. Il peut prendre l'une des valeurs suivantes :

0 = Jamais

1 = En cas de réussite du travail

2 = En cas d'échec du travail

3 = À la fin du travail (quelle qu'en soit l'issue)

notify_level_email

int

Masque de bits indiquant les conditions d'envoi d'un message électronique en fin de travail. Les valeurs possibles sont identiques à celles de 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 identiques à celles de 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 identiques à celles de notify_level_eventlog.

notify_email_operator

sysname

Adresse électronique de l'opérateur à avertir.

notify_netsend_operator

sysname

Nom de l'utilisateur ou de l'ordinateur utilisé pour envoyer les messages 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 identiques à celles de 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 = Succès

3 = Annulation

5 = Inconnu

next_run_date

int

Date prévue de la prochaine exécution du travail.

next_run_time

int

Heure prévue de 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 de l'exécution en cours.

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 fait l'objet de plusieurs tentatives d'exécution, 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 = Travail sans serveur cible.

Notes

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

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.

Les membres du rôle SQLAgentUserRole peuvent consulter uniquement l'état des travaux dont ils sont propriétaires.

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