sp_help_jobs_in_schedule (Transact-SQL)
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 Zeitplanes, für den Informationen aufgelistet werden. schedule_id ist ein Wert vom Datentyp int und weist keinen Standardwert auf. Es kann entweder schedule_id oder schedule_name angegeben werden.
- [ @schedule_name = ] 'schedule_name'
Der Name des Zeitplanes, für den Informationen aufgelistet werden. schedule_name ist ein Wert vom Datentyp sysname und weist keinen Standardwert auf. Es kann entweder 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 |
Name des Auftrags. |
enabled |
tinyint |
Zeigt an, ob der Auftrag für die Ausführung aktiviert ist. |
description |
nvarchar(512) |
Beschreibung für den Auftrag. |
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. Kann einen der folgenden Werte annehmen: 0 = Nie 1 = Bei erfolgreicher Ausführung des Auftrags 2 = Bei Fehlschlagen des Auftrags 3 = Bei Abschluss des Auftrags (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. Dieselben Werte wie bei notify_level_eventlog sind möglich. |
notify_level_netsend |
int |
Bitmaske, die anzeigt, unter welchen Umständen bei Abschluss eines Auftrags eine Netzwerkmeldung gesendet werden soll. Dieselben Werte wie bei notify_level_eventlog sind möglich. |
notify_level_page |
int |
Bitmaske, die anzeigt, unter welchen Umständen bei Abschluss eines Auftrags eine Benachrichtigung per Pager gesendet werden soll. Dieselben Werte wie bei notify_level_eventlog sind möglich. |
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. Dieselben Werte wie bei notify_level_eventlog sind möglich. |
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 der letzten Ausführung des Auftrags: 0 = Fehlgeschlagen 1 = Erfolgreich 3 = Abgebrochen 5 = Unbekannt |
next_run_date |
int |
Datum, an dem 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 von Auftragsschritten des Auftrags. |
has_schedule |
int |
Anzahl von Auftragszeitplänen des Auftrags. |
has_target |
int |
Anzahl von Zielservern des Auftrags. |
type |
int |
Auftragstyp: 1 = Lokaler Auftrag 2 = Multiserverauftrag 0 = Auftrag hat keine Zielserver |
Hinweise
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 der Aufträge anzeigen, deren Besitzer sie sind.
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
Siehe auch
Verweis
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)