Pomocí sp_help_schedule v SQL Server

V SQL Server, sp_help_schedule uložená procedura vrací informace o plánech v SQL Server Agent.

Tento článek poskytuje přehled této uložené procedury včetně příkladů.

Syntaxe

Oficiální syntaxe vypadá takto:

sp_help_schedule   
     [ @schedule_id = ] id ,  
     [ @schedule_name = ] 'schedule_name'   
     [ , [ @attached_schedules_only = ] attached_schedules_only ]  
     [ , [ @include_description = ] include_description ]

Můžete zavolat sp_help_schedule s parametry nebo bez nich.

Když jej zavoláte bez jakýchkoli parametrů, vrátí seznam všech plánů v instanci.

Když předáte buď název plánu nebo ID, vrátí právě tento plán.

Všimněte si, že sp_help_schedule je v msdb databázi, takže je třeba ji spouštět odtud. Můžete to provést buď přepnutím do msdb databáze (např. pomocí USE msdb ), nebo kvalifikací postupu s názvem databáze a schématem (tj. msdb.dbo.sp_help_schedule ).

Příklad

Zde je příklad demonstrující, jak vrátit všechny plány v instanci:

EXEC msdb.dbo.sp_help_schedule;

Výsledek:

Vrátit plán na základě jeho názvu

Můžete také získat plán založený na jeho názvu:

EXEC msdb.dbo.sp_help_schedule
	@schedule_name = 'Weekly_Sun_3AM';

Vrátit plán na základě jeho ID

Alternativně můžete získat plán na základě jeho ID:

EXEC msdb.dbo.sp_help_schedule
	@schedule_id = 14;

Vracet pouze připojené plány

Ačkoli sp_help_schedule nevrací plány pro konkrétní úlohu (použijte sp_help_jobschedule za to), můžete jej použít k vrácení pouze těch rozvrhů, které jsou připojeny k úloze.

Můžete to udělat pomocí @attached_schedules_only parametr.

@attached_schedules_only parametr je bit , s výchozí hodnotou 0 , což znamená, že vrací připojené i nepřipojené plány. Předání hodnoty 1 omezuje to pouze na připojené plány.

Příklad:

EXEC sp_help_schedule
	@attached_schedules_only = 1;

Zahrňte popis

Další věc, kterou můžete udělat, je určit, zda chcete zahrnout popis plánu.

Ve výchozím nastavení není popis součástí sady výsledků. Vlastně schedule_description sloupec je zahrnuto, ale neobsahuje popis, pokud si to výslovně nevyžádáte. Pokud o to nepožádáte, schedule_description sloupec zobrazuje (Description not requested.) .

@include_description parametr je bit , s výchozí hodnotou 0 , což znamená, že nezobrazuje popis. Předání hodnoty 1 způsobí zobrazení popisu.

EXEC sp_help_jobschedule
	@job_name = 'SqlAgentTest',
	@include_description = 1;