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 = ] 'job_name' }
[ , [ @schedule_name = ] 'schedule_name' ]
[ , [ @schedule_id = ] schedule_id ]
[ , [ @include_description = ] include_description ]
Argumente
[ @job_id = ] job_id
Die Auftragsidentifikationsnummer. job_idist uniqueidentifier mit dem Standardwert NULL.
[ @job_name = ] 'job_name'
Der Name des Auftrags. job_nameist sysname mit dem Standardwert NULL.
Hinweis
Es müssen entweder job_id oder job_name angegeben werden, aber beide können nicht angegeben werden.
[ @schedule_name = ] 'schedule_name'
Der Name des Zeitplanelements für den Auftrag. schedule_nameist sysname mit dem Standardwert NULL.
[ @schedule_id = ] schedule_id
Die Identifikationsnummer des Planelements für den Auftrag. schedule_idist int mit dem Standardwert NULL.
[ @include_description = ] include_description
Gibt an, ob die Beschreibung des Zeitplans in das Resultset eingeschlossen werden soll. include_description ist Bit, wobei der Standardwert 0 ist. Wenn include_description0 ist, ist die Beschreibung des Zeitplans nicht im Resultset enthalten. Wenn include_description1 ist, ist die Beschreibung des Zeitplans im Resultset enthalten.
Rückgabecodewerte
„0“ (erfolgreich) oder „1“ (fehlerhaft)
Resultsets
Spaltenname | Datentyp | BESCHREIBUNG |
---|---|---|
schedule_id | int | ID des Zeitplans. |
schedule_name | sysname | Name des Zeitplans. |
enabled | int | Gibt an, ob der Zeitplan aktiviert ist (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 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 der freq_subday_type Zeiträume, die zwischen jeder Ausführung des Auftrags auftreten. Weitere Informationen finden Sie unter sp_add_schedule (Transact-SQL). |
freq_relative_interval | int | Das Auftreten des freq_interval des geplanten Auftrags in jedem Monat. Weitere Informationen finden Sie unter sp_add_schedule (Transact-SQL). |
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 in msdb.dbo.sysschedules abgeleitet ist. Wenn include_description0 ist, enthält diese Spalte Text, der angibt, 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 | Die Anzahl der zurückgegebenen Aufträge. |
Hinweis
sp_help_jobschedule** gibt Werte aus den Systemtabellen dbo.sysjobschedules und dbo.sysschedules in msdb zurück. sysjobscheduls updates alle 20 Minuten. Dies kann Auswirkungen auf die Werte haben, die von dieser gespeicherten Prozedur zurückgegeben werden.
Bemerkungen
Die Parameter von sp_help_jobschedule können nur in bestimmten Kombinationen verwendet werden. Wenn schedule_id angegeben ist, können weder job_id noch job_name angegeben werden. Andernfalls können die Parameter job_id oder job_name mit schedule_name verwendet werden.
Berechtigungen
Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin . 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, 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 Auftragszeitplans 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 Zeitplans ein.
USE msdb ;
GO
EXEC dbo.sp_help_jobschedule
@job_name = N'RunReports',
@schedule_name = N'NightlyJobs',
@include_description = 1 ;
GO
Weitere Informationen
sp_add_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_update_schedule (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für