sp_help_jobs_in_schedule (Transact-SQL)

Artikel
11/07/2023

Gibt Informationen zu den Aufträgen zurück, an die ein bestimmter Zeitplan angefügt ist.

Syntax

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

Argumente

[ @schedule_id = ] schedule_id Der Bezeichner des Zeitplans, für den Informationen aufgelistet werden sollen. schedule_id ist int ohne Standardwert. Es können schedule_id oder schedule_name angegeben werden.

[ @schedule_name = ] 'schedule_name' Der Name des Zeitplans, für den Informationen aufgelistet werden sollen. schedule_name ist sysname, ohne Standardwert. Es können schedule_id oder schedule_name angegeben werden.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Gibt das folgende Resultset zurück:

Spaltenname	Datentyp	BESCHREIBUNG
job_id	uniqueidentifier	Eindeutige ID des Auftrags.
originating_server	nvarchar(30)	Name des Servers, von dem der Auftrag stammt
name	sysname	Der Name des Auftrags.
enabled	tinyint	Zeigt an, ob der Auftrag für die Ausführung aktiviert ist.
description	nvarchar(512)	Die Beschreibung des Auftrags.
start_step_id	int	ID des Schrittes in dem Auftrag, bei dem die Ausführung beginnen soll.
category	sysname	Auftragskategorie
owner	sysname	Auftragsbesitzer
notify_level_eventlog	int	Bitmaske, die anzeigt, unter welchen Umständen ein Benachrichtigungsereignis im Microsoft Windows-Anwendungsprotokoll protokolliert werden soll. Einer der folgenden Werte ist möglich: 0 = Nie 1 = Wenn ein Auftrag erfolgreich ist 2 = Bei Fehlschlagen des Auftrags 3 = Immer, wenn der Auftrag abgeschlossen ist (unabhängig vom Ergebnis des Auftrags)
notify_level_email	int	Bitmaske, die anzeigt, unter welchen Umständen bei Abschluss eines Auftrags eine Benachrichtigungs-E-Mail gesendet werden soll. Mögliche Werte sind mit denen für notify_level_eventlog identisch.
notify_level_netsend	int	Bitmaske, die anzeigt, unter welchen Umständen bei Abschluss eines Auftrags eine Netzwerkmeldung gesendet werden soll. Mögliche Werte sind mit denen für notify_level_eventlog identisch.
notify_level_page	int	Bitmaske, die anzeigt, unter welchen Umständen bei Abschluss eines Auftrags eine Benachrichtigung per Pager gesendet werden soll. Mögliche Werte sind mit denen für notify_level_eventlog identisch.
notify_email_operator	sysname	E-Mail-Name des Operators, der benachrichtigt werden soll.
notify_netsend_operator	sysname	Name des Computers oder Benutzers, der beim Senden von Netzwerkmeldungen verwendet wird
notify_page_operator	sysname	Name des Computers oder Benutzers, der beim Senden einer Pagerbenachrichtigung verwendet wird
delete_level	int	Bitmaske, die anzeigt, unter welchen Umständen der Auftrag bei Abschluss eines Auftrags gelöscht werden soll. Mögliche Werte sind mit denen für notify_level_eventlog identisch.
date_created	datetime	Datum, an dem der Auftrag erstellt wurde.
date_modified	datetime	Datum, an dem der Auftrag zuletzt geändert wurde.
version_number	int	Version des Auftrags (wird automatisch jedes Mal aktualisiert, wenn der Auftrag geändert wird)
last_run_date	int	Datum, an dem die Ausführung des Auftrags zuletzt gestartet wurde
last_run_time	int	Uhrzeit, zu der die Ausführung des Auftrags zuletzt gestartet wurde
last_run_outcome	int	Ergebnis des Auftrags bei der letzten Ausführung: 0 = Fehler 1 = Erfolgreich 3 = Abgebrochen 5 = Unbekannt
next_run_date	int	Datum, für das die nächste Ausführung des Auftrags geplant ist
next_run_time	int	Uhrzeit, zu der die nächste Ausführung des Auftrags geplant ist
next_run_schedule_id	int	Zeitplan-ID für nächste Ausführung
current_execution_status	int	Aktueller Ausführungsstatus
current_execution_step	sysname	Aktueller Ausführungsschritt des Auftrags
current_retry_attempt	int	Wenn der Auftrag ausgeführt wird und der Schritt wiederholt wurde, ist dies der aktuelle Wiederholungsversuch
has_step	int	Anzahl der Auftragsschritte des Auftrags
has_schedule	int	Anzahl der Auftragszeitpläne des Auftrags
has_target	int	Die Anzahl der Zielserver des Auftrags.
type	int	Auftragstyp: 1 = Lokaler Auftrag. 2 = Multiserverauftrag. 0 = Auftrag verfügt über keine Zielserver.

Bemerkungen

In dieser Prozedur werden Informationen aufgelistet, die an den bestimmten Zeitplan angefügt sind.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Andere Benutzer müssen Mitglieder der festen SQL Server -Agent-Datenbankrollen in der msdb -Datenbank sein:

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.

Mitglieder von SQLAgentUserRole können nur den Status von Aufträgen anzeigen, die sie besitzen.

Beispiele

Im folgenden Beispiel werden die dem Zeitplan NightlyJobs angefügten Aufträge aufgelistet.

USE msdb ;  
GO  
  
EXEC sp_help_jobs_in_schedule  
    @schedule_name = N'NightlyJobs' ;  
GO

Weitere Informationen

Gespeicherte Prozeduren des SQL Server-Agents (Transact-SQL)
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)