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 = ] id ,
[ @schedule_name = ] 'schedule_name'
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
Argumente
[ @schedule_id = ] id
Der Bezeichner des auflistenden Zeitplans. schedule_name ist int ohne Standardwert. Es kann entweder schedule_id oder schedule_name angegeben werden.
[ @schedule_name = ] 'schedule_name'
Der Name des auflistenden Zeitplans. schedule_name ist sysname ohne Standardwert. Es kann entweder schedule_id oder schedule_name angegeben werden.
[ @attached_schedules_only = ] attached_schedules_only ]
Gibt an, ob nur Zeitpläne angezeigt werden sollen, an die ein Auftrag angefügt ist. attached_schedules_only ist Bit mit dem Standardwert 0. Wenn attached_schedules_only0 ist, werden alle Zeitpläne angezeigt. Wenn attached_schedules_only1 ist, enthält das Resultset nur Zeitpläne, die an einen Auftrag angefügt sind.
[ @include_description = ] include_description
Gibt an, ob Beschreibungen in das Resultset eingeschlossen werden sollen. include_description ist Bit mit dem Standardwert 0. Wenn include_description0 ist, enthält die schedule_description Spalte des Resultsets einen Platzhalter. Wenn include_description1 ist, wird die Beschreibung des Zeitplans im Resultset enthalten.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Resultsets
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 ist (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 Vorkommen der freq_interval für den geplanten Auftrag 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 Beschreibung des Zeitplans in englischer Sprache (falls angefordert). |
job_count | int | Gibt die Anzahl von Aufträgen zurück, die auf diesen Zeitplan verweisen. |
Bemerkungen
Wenn keine Parameter bereitgestellt werden, listet sp_help_schedule Informationen zu allen Zeitplänen in der Instanz auf.
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 die Zeitpläne anzeigen, die sie besitzen.
Beispiele
A. Auflisten der 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 der 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
Weitere Informationen
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (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