Freigeben über


sp_help_schedule (Transact-SQL)

Gilt für: SQL Server

Listet Informationen zu Zeitplänen auf.

Transact-SQL-Syntaxkonventionen

Syntax

sp_help_schedule
    [ [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @attached_schedules_only = ] attached_schedules_only ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Argumente

[ @schedule_id = ] schedule_id

Der Bezeichner des Zeitplans, der aufgelistet werden soll. @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, der aufgelistet werden soll. @schedule_name ist "sysname" mit der Standardeinstellung "NULL.

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

[ @attached_schedules_only = ] attached_schedules_only

Gibt an, ob nur Zeitpläne angezeigt werden sollen, denen ein Auftrag angefügt ist. @attached_schedules_only ist bit, mit einem Standardwert von 0. Wenn @attached_schedules_only ist 0, werden alle Zeitpläne angezeigt. Wenn @attached_schedules_only ist 1, enthält das Resultset nur Zeitpläne, die einem Auftrag zugeordnet sind.

[ @include_description = ] include_description

Gibt an, ob das Resultset Beschreibungen enthalten soll. @include_description ist bit, mit einem Standardwert von 0. Wenn @include_description ist 0, enthält die @schedule_description Spalte des Resultsets einen Platzhalter. Wenn @include_description ist, ist 1die Beschreibung des Zeitplans im Resultset enthalten.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Diese Prozedur gibt das folgende Resultset zurück:

Spaltenname Datentyp BESCHREIBUNG
schedule_id int ID des Zeitplans.
schedule_uid uniqueidentifier Bezeichner für den Zeitplan.
schedule_name sysname Name des Zeitplans.
enabled int Gibt an, ob der Zeitplan aktiviert (1) oder nicht aktiviert (0).
freq_type int Wert, der angibt, wann der Auftrag ausgeführt werden soll.

1 = Einmal
4 = Täglich
8 = Wöchentlich
16 = Monatlich
32 = Monatlich, relativ zum freq_interval
64 = Ausführen, wenn der SQLServerAgent-Dienst gestartet wird.
freq_interval int Tage, an dem der Auftrag ausgeführt wird. Der Wert hängt vom Wert von freq_type. Weitere Informationen finden Sie unter sp_add_schedule.
freq_subday_type int Einheiten für freq_subday_interval. Weitere Informationen finden Sie unter sp_add_schedule.
freq_subday_interval int Anzahl der freq_subday_type Perioden, die zwischen jeder Ausführung des Auftrags auftreten sollen. Weitere Informationen finden Sie unter sp_add_schedule.
freq_relative_interval int Das Vorkommen des geplanten Auftrags in freq_interval jedem Monat. Weitere Informationen finden Sie unter sp_add_schedule.
freq_recurrence_factor int Anzahl der Monate zwischen der geplanten Ausführung des Auftrags
active_start_date int Datum, an dem der Zeitplan aktiviert wird.
active_end_date int Enddatum für den Zeitplan.
active_start_time int Uhrzeit, zu der der Zeitplan gestartet wird.
active_end_time int Uhrzeit, zu der der Zeitplan beendet wird.
date_created datetime Datum, an dem der Zeitplan erstellt wird
schedule_description nvarchar(4000) Eine Beschreibung des Zeitplans in englischer Sprache (falls angefordert).
job_count int Gibt die Anzahl von Aufträgen zurück, die auf diesen Zeitplan verweisen.

Hinweise

Wenn keine Parameter bereitgestellt werden, sp_help_schedule werden Informationen für alle Zeitpläne in der Instanz aufgelistet.

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 die Zeitpläne anzeigen, die sie besitzen.

Beispiele

A. Auflisten von Informationen für alle Zeitpläne in der Instanz

Im folgenden Beispiel werden die Informationen für alle Zeitpläne in der Instanz aufgelistet.

USE msdb;
GO

EXEC dbo.sp_help_schedule;
GO

B. Auflisten von Informationen für einen bestimmten Zeitplan

Im folgenden Beispiel werden Informationen zum Zeitplan NightlyJobs aufgelistet.

USE msdb;
GO

EXEC dbo.sp_help_schedule
    @schedule_name = N'NightlyJobs';
GO