Sqlserver
 sql >> Datenbank >  >> RDS >> Sqlserver

Verwenden von sp_help_schedule in SQL Server

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;