In SQL Server ist der sp_help_schedule
gespeicherte Prozedur gibt Informationen zu Zeitplänen im SQL Server-Agent zurück.
Dieser Artikel bietet einen Überblick über diese gespeicherte Prozedur, einschließlich Beispielen.
Syntax
Die offizielle Syntax lautet wie folgt:
sp_help_schedule
[ @schedule_id = ] id ,
[ @schedule_name = ] 'schedule_name'
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
Sie können sp_help_schedule
aufrufen , mit oder ohne Parameter.
Wenn Sie es ohne Parameter aufrufen, gibt es eine Liste aller Zeitpläne in der Instanz zurück.
Wenn Sie entweder einen Zeitplannamen oder eine ID übergeben, wird nur dieser Zeitplan zurückgegeben.
Beachten Sie, dass sp_help_schedule
befindet sich in der msdb Datenbank, also muss es von dort ausgeführt werden. Sie können dies entweder tun, indem Sie in die msdb wechseln Datenbank (z.B. mit USE msdb
) oder indem Sie die Prozedur mit dem Datenbanknamen und Schema qualifizieren (d. h. msdb.dbo.sp_help_schedule
).
Beispiel
Hier ist ein Beispiel, das zeigt, wie alle Zeitpläne in der Instanz zurückgegeben werden:
EXEC msdb.dbo.sp_help_schedule;
Ergebnis:
Geben Sie einen Zeitplan basierend auf seinem Namen zurück
Sie können auch einen Zeitplan basierend auf seinem Namen abrufen:
EXEC msdb.dbo.sp_help_schedule
@schedule_name = 'Weekly_Sun_3AM';
Einen Zeitplan basierend auf seiner ID zurückgeben
Alternativ können Sie einen Zeitplan basierend auf seiner ID abrufen:
EXEC msdb.dbo.sp_help_schedule
@schedule_id = 14;
Nur angehängte Zeitpläne zurückgeben
Obwohl sp_help_schedule
gibt keine Zeitpläne für einen bestimmten Job zurück (verwenden Sie sp_help_jobschedule
dafür), können Sie es verwenden, um nur die Zeitpläne zurückzugeben, die einem Job zugeordnet sind.
Sie können dies mit dem @attached_schedules_only
tun Parameter.
Der @attached_schedules_only
Parameter ist bit , mit einem Standardwert von 0
, was bedeutet, dass sowohl angehängte als auch nicht angehängte Zeitpläne zurückgegeben werden. Übergeben eines Werts von 1
beschränkt es auf nur angehängte Zeitpläne.
Beispiel:
EXEC sp_help_schedule
@attached_schedules_only = 1;
Beschreibung hinzufügen
Sie können auch angeben, ob die Beschreibung des Zeitplans enthalten sein soll oder nicht.
Standardmäßig ist die Beschreibung nicht in der Ergebnismenge enthalten. Eigentlich die schedule_description
Spalte ist enthalten, enthält jedoch nicht die Beschreibung, es sei denn, Sie fordern dies ausdrücklich an. Wenn Sie es nicht anfordern, die schedule_description
Spalte zeigt (Description not requested.)
an .
Der @include_description
Parameter ist bit , mit einem Standardwert von 0
, was bedeutet, dass die Beschreibung nicht angezeigt wird. Übergeben eines Werts von 1
bewirkt, dass die Beschreibung angezeigt wird.
EXEC sp_help_jobschedule
@job_name = 'SqlAgentTest',
@include_description = 1;