sp_help_jobschedule (Transact-SQL)

Gilt für: SQL Server

Gibt Informationen zur Planung von Aufträgen zurück, die von SQL Server Management Studio zum Ausführen automatisierter Aktivitäten verwendet werden.

Transact-SQL-Syntaxkonventionen

Syntax

sp_help_jobschedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Argumente

[ @job_id = ] 'job_id'

Die Auftrags-ID @job_id ist eindeutiger Bezeichner mit einem Standardwert von NULL.

Entweder @job_id oder @job_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

[ @job_name = ] N'job_name'

Der Name des Auftrags. @job_name ist "sysname" mit der Standardeinstellung "NULL.

Entweder @job_id oder @job_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

[ @schedule_name = ] N'schedule_name'

Der Name des Zeitplanelements für den Auftrag. @schedule_name ist "sysname" mit der Standardeinstellung "NULL.

[ @schedule_id = ] schedule_id

Die Identifikationsnummer des Zeitplanelements für den Auftrag. @schedule_id ist int mit einem Standardwert von NULL.

[ @include_description = ] include_description

Gibt an, ob die Beschreibung des Zeitplans in das Resultset eingeschlossen werden soll. @include_description ist bit, mit einem Standardwert von 0.

  • Wenn 0die Beschreibung des Zeitplans nicht im Resultset enthalten ist.
  • Wenn 1die Beschreibung des Zeitplans im Resultset enthalten ist.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Spaltenname Datentyp BESCHREIBUNG
schedule_id int ID des Zeitplans.
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 SQL Server-Agent 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 englische Beschreibung des Zeitplans, der von Werten msdb.dbo.sysschedulesin . Wenn @include_description ist 0, enthält diese Spalte Text, der angibt, dass die Beschreibung nicht angefordert wurde.
next_run_date int Datum, an dem der Zeitplan als Nächstes ausgeführt wird.
next_run_time int Wenn der Zeitplan als nächstes ausgeführt wird, wird der Auftrag ausgeführt.
schedule_uid uniqueidentifier Bezeichner für den Zeitplan.
job_count int Die Anzahl der zurückgegebenen Aufträge.

Hinweis

sp_help_jobschedule gibt Werte aus den dbo.sysjobschedules Tabellen und dbo.sysschedules Systemtabellen in msdb.sysjobschedules Aktualisierungen alle 20 Minuten zurück. Dies kann Auswirkungen auf die Werte haben, die von dieser gespeicherten Prozedur zurückgegeben werden.

Hinweise

Die Parameter können sp_help_jobschedule nur in bestimmten Kombinationen verwendet werden. Wenn @schedule_id angegeben ist, können @job_id und @job_name nicht angegeben werden. Andernfalls können die parameter @job_id oder @job_name mit @schedule_name verwendet werden.

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 Eigenschaften von Auftragsplänen anzeigen, die sie besitzen.

Beispiele

A. Zurückgeben des Auftragszeitplans für einen bestimmten Auftrag

Im folgenden Beispiel werden die Zeitplaninformationen für einen Auftrag namens BackupDatabase zurückgegeben

USE msdb;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'BackupDatabase' ;
GO

B. Zurückgeben des Auftragszeitplans für einen bestimmten Zeitplan

Im folgenden Beispiel werden die Informationen für den Zeitplan NightlyJobs und den Auftrag RunReports zurückgegeben.

USE msdb;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs';
GO

C. Zurückgeben des Auftragsplans und der Terminplanbeschreibung für einen bestimmten Zeitplan

Im folgenden Beispiel werden die Informationen für den Zeitplan NightlyJobs und den Auftrag RunReports zurückgegeben. Das zurückgegebene Resultset schließt eine Beschreibung des Zeitplans ein.

USE msdb;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs',
    @include_description = 1;
GO