sp_help_jobschedule (Transact-SQL)

Gibt Informationen zur Zeitplanung von Aufträgen zurück, mit denen SQL Server Management Studio automatisierte Aktivitäten ausführt.

Syntax

sp_help_jobschedule { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
     [ , [ @schedule_name = ] 'schedule_name' ]
     [ , [ @schedule_id = ] schedule_id ]
     [ , [ @include_description = ] include_description ]

Argumente

• [ @job_id= ] job_id
  Die ID des Auftrags. job_id ist ein Wert vom Datentyp uniqueidentifier; der Standardwert ist NULL.

• [ @job_name= ] 'job_name'
  Der Name des Auftrags. job_name ist ein Wert vom Datentyp sysname. Der Standardwert ist NULL.

  Hinweis:
  Es muss entweder job_id oder job_name angegeben werden, beide Angaben sind jedoch nicht möglich.

• [ @schedule_name= ] 'schedule_name'
  Der Name des Zeitplanelements für den Auftrag. schedule_name ist vom Datentyp sysname; der Standardwert ist NULL.

• [ @schedule_id= ] schedule_id
  Die ID des Zeitplanelements für den Auftrag. schedule_id ist vom Datentyp int; der Standardwert ist NULL.

• [ @include_description= ] include_description
  Gibt an, ob die Beschreibung des Zeitplanes im Resultset eingeschlossen werden soll. include_description ist ein Wert vom Datentyp bit; der Standardwert ist 0. Wenn include_description gleich 0 ist, wird die Beschreibung des Zeitplanes nicht in das Resultset eingeschlossen. Wenn include_description gleich 1 ist, wird die Beschreibung des Zeitplanes in das Resultset eingeschlossen.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname	Datentyp	Beschreibung
schedule_id	int	ID des Zeitplanes.
schedule_name	sysname	Name des Zeitplanes.
enabled	int	Gibt an, ob der Zeitplan aktiviert (1) oder deaktiviert (0) ist.
freq_type	int	Zeigt an, wann der Auftrag ausgeführt werden soll: 1 = Einmal 4 = Täglich 8 = Wöchentlich 16 = Monatlich 32 = Monatlich, in Abhängigkeit von freq_interval 64 = Ausführung, wenn der SQLServerAgent-Dienst gestartet wird.
freq_interval	int	Tage, an denen der Auftrag ausgeführt wird. Der Wert hängt vom Wert für freq_type ab. Weitere Informationen finden Sie unter sp_add_schedule (Transact-SQL).
freq_subday_type	int	Einheiten für freq_subday_interval. Weitere Informationen finden Sie unter sp_add_schedule (Transact-SQL).
freq_subday_interval	int	Anzahl von freq_subday_type-Perioden, die zwischen den einzelnen Ausführungen des Auftrags auftreten. Weitere Informationen finden Sie unter sp_add_schedule (Transact-SQL).
freq_relative_interval	int	Auftreten von freq_interval des geplanten Auftrags in jedem Monat. Weitere Informationen finden Sie unter sp_add_schedule (Transact-SQL).
freq_recurrence_factor	int	Anzahl von Monaten 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 in msdb.dbo.sysschedules abgeleitet wurde. Wenn include_description gleich 0 ist, enthält diese Spalte Text, der besagt, dass die Beschreibung nicht angefordert wurde.
next_run_date	int	Datum, an dem der Zeitplan die nächste Ausführung des Auftrags bewirken wird.
next_run_time	int	Uhrzeit, zu der der Zeitplan die nächste Ausführung des Auftrags bewirken wird.
schedule_uid	uniqueidentifier	Bezeichner für den Zeitplan.
job_count	int	Anzahl zurückgegebener Aufträge.

Hinweis:
sp_help_jobschedule gibt Werte aus der sysjobschedules- und dbo.sysschedules-Systemtabelle in msdb zurück. sysjobschedules wird alle 20 Minuten aktualisiert. Dies kann sich auf die Werte auswirken, die von dieser gespeicherten Prozedur zurückgegeben werden.

Hinweise

Die Parameter von sp_help_jobschedule können nur in bestimmten Kombinationen verwendet werden. Wenn schedule_id angegeben wird, können weder job_id noch job_name angegeben werden. Andernfalls können die Parameter von job_id oder job_name mit schedule_name verwendet werden.

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 Eigenschaften von Auftragszeitplänen anzeigen, deren Besitzer sie sind.

Beispiele

A. Zurückgeben des Auftragszeitplanes 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 Auftragszeitplanes 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 Auftragszeitplanes und der Zeitplanbeschreibung 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 Zeitplanes ein.

USE msdb ;
GO

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

Siehe auch

Verweis

sp_add_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_update_schedule (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)

Hilfe und Informationen

Informationsquellen für SQL Server 2005