Anmerkung
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
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 = Einmal4 = Täglich8 = Wöchentlich16 = Monatlich32 = Monatlich, relativ zum freq_interval64= 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
Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE , aber diese Berechtigungen können 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
EXECUTE 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
EXECUTE 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
EXECUTE dbo.sp_help_jobschedule
@job_name = N'RunReports',
@schedule_name = N'NightlyJobs',
@include_description = 1;
GO