Używanie sp_help_schedule w SQL Server

W SQL Server sp_help_schedule procedura składowana zwraca informacje o harmonogramach w programie SQL Server Agent.

Ten artykuł zawiera omówienie tej procedury składowanej wraz z przykładami.

Składnia

Oficjalna składnia wygląda następująco:

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

Możesz zadzwonić do sp_help_schedule , z parametrami lub bez.

Gdy wywołasz go bez żadnych parametrów, zwróci listę wszystkich harmonogramów w instancji.

Gdy podasz nazwę lub identyfikator harmonogramu, zwracany jest tylko ten harmonogram.

Pamiętaj, że sp_help_schedule jest w msdb bazy danych, więc trzeba ją stamtąd uruchomić. Możesz to zrobić, przechodząc do msdb baza danych (np. z USE msdb ) lub przez zakwalifikowanie procedury nazwą i schematem bazy danych (np. msdb.dbo.sp_help_schedule ).

Przykład

Oto przykład pokazujący, jak zwrócić wszystkie harmonogramy w instancji:

EXEC msdb.dbo.sp_help_schedule;

Wynik:

Zwróć harmonogram na podstawie jego nazwy

Możesz również uzyskać harmonogram na podstawie jego nazwy:

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

Zwróć harmonogram na podstawie jego identyfikatora

Alternatywnie możesz uzyskać harmonogram na podstawie jego identyfikatora:

EXEC msdb.dbo.sp_help_schedule
	@schedule_id = 14;

Zwróć tylko załączone harmonogramy

Chociaż sp_help_schedule nie zwraca harmonogramów dla określonego zadania (użyj sp_help_jobschedule w tym celu), możesz go użyć do zwrócenia tylko tych harmonogramów, które są dołączone do zadania.

Możesz to zrobić za pomocą @attached_schedules_only parametr.

@attached_schedules_only parametr to bit , domyślnie 0 , co oznacza, że ​​zwraca zarówno dołączone, jak i niedołączone harmonogramy. Przekazywanie wartości 1 ogranicza to tylko do dołączonych harmonogramów.

Przykład:

EXEC sp_help_schedule
	@attached_schedules_only = 1;

Dołącz opis

Inną rzeczą, którą możesz zrobić, to określić, czy dołączać opis harmonogramu.

Domyślnie opis nie jest zawarty w zestawie wyników. Właściwie schedule_description kolumna jest zawarte, ale nie zawiera opisu, chyba że wyraźnie o to poprosisz. Jeśli o to nie poprosisz, schedule_description kolumna wyświetla (Description not requested.) .

@include_description parametr to bit , domyślnie 0 , co oznacza, że ​​opis nie jest wyświetlany. Przekazywanie wartości 1 powoduje wyświetlenie opisu.

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