Използване на sp_help_schedule в SQL Server

В SQL Server, sp_help_schedule Съхранената процедура връща информация за графиците в SQL Server Agent.

Тази статия предоставя общ преглед на тази съхранена процедура, включително примери.

Синтаксис

Официалният синтаксис е така:

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

Можете да се обадите на sp_help_schedule , със или без параметри.

Когато го извикате без никакви параметри, той връща списък с всички графици в екземпляра.

Когато подадете или име на график, или идентификатор, той връща точно този график.

Обърнете внимание, че sp_help_schedule е в msdb база данни, така че трябва да се стартира от там. Можете да направите това или като преминете към msdb база данни (например с USE msdb ), или чрез квалифициране на процедурата с името на базата данни и схемата (т.е. msdb.dbo.sp_help_schedule ).

Пример

Ето пример, за да демонстрирате как да върнете всички графици в екземпляра:

EXEC msdb.dbo.sp_help_schedule;

Резултат:

Връщане на график въз основа на неговото име

Можете също да получите график въз основа на неговото име:

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

Връщане на график въз основа на неговия идентификатор

Като алтернатива можете да получите график въз основа на неговия идентификатор:

EXEC msdb.dbo.sp_help_schedule
	@schedule_id = 14;

Връщане само на прикачени графици

Въпреки че sp_help_schedule не връща графици за конкретна работа (използвайте sp_help_jobschedule за това), можете да го използвате, за да върнете само онези графици, които са прикачени към задание.

Можете да направите това с @attached_schedules_only параметър.

@attached_schedules_only параметърът е бит , със стойност по подразбиране 0 , което означава, че връща както прикачени, така и неприкачени графици. Подаване на стойност от 1 го ограничава до само прикачени графици.

Пример:

EXEC sp_help_schedule
	@attached_schedules_only = 1;

Включете описанието

Друго нещо, което можете да направите, е да посочите дали да включите или не описанието на графика.

По подразбиране описанието не е включено в набора от резултати. Всъщност, schedule_description колона е включен, но не съдържа описанието, освен ако не го поискате изрично. Ако не го поискате, schedule_description колоната показва (Description not requested.) .

@include_description параметърът е бит , със стойност по подразбиране 0 , което означава, че не показва описанието. Подаване на стойност от 1 води до показване на описанието.

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