Teilen über

sp_help_jobs_in_schedule (Transact-SQL)

  • Artikel

Gilt für: SQL Server

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

Transact-SQL-Syntaxkonventionen

Syntax

sp_help_jobs_in_schedule
    [ [ @schedule_name = ] N'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 mit einem Standardwert von NULL.

Entweder @schedule_id oder @schedule_name können angegeben werden.

[ @schedule_name = ] N'schedule_name'

Der Name des Zeitplans, für den Informationen aufgelistet werden sollen. @schedule_name ist "sysname" mit der Standardeinstellung "NULL.

Entweder @schedule_id oder @schedule_name können angegeben werden.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

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 Gibt an, ob der Auftrag aktiviert ist, damit er ausgeführt werden kann.
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 = Wenn der Auftrag fehlschlägt
3 = Wann immer der Auftrag abgeschlossen ist (unabhängig vom Arbeitsergebnis)
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 identisch mit .notify_level_eventlog
notify_level_netsend int Bitmaske, die anzeigt, unter welchen Umständen bei Abschluss eines Auftrags eine Netzwerkmeldung gesendet werden soll. Mögliche Werte sind identisch mit .notify_level_eventlog
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 identisch mit .notify_level_eventlog
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 identisch mit .notify_level_eventlog
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 beim letzten Ausführungsvorgang:

0 = Fehlgeschlagen
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 erneut versucht wurde, ist dieser Wert 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 Typ des Auftrags:

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

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Anderen Benutzern muss eine der folgenden SQL Server-Agent festen Datenbankrollen in der msdb Datenbank gewährt werden:

  • 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

Zugehöriger Inhalt