Brug af sp_help_schedule i SQL Server

I SQL Server er sp_help_schedule lagret procedure returnerer oplysninger om tidsplaner i SQL Server Agent.

Denne artikel giver et overblik over denne lagrede procedure inklusive eksempler.

Syntaks

Den officielle syntaks lyder sådan her:

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

Du kan ringe til sp_help_schedule , med eller uden parametre.

Når du kalder det uden nogen parametre, returnerer det en liste over alle tidsplaner i forekomsten.

Når du passerer enten et skemanavn eller ID, returnerer det netop denne tidsplan.

Bemærk at sp_help_schedule er i msdb database, så den skal køres derfra. Du kan gøre dette enten ved at skifte til msdb database (f.eks. med USE msdb ), eller ved at kvalificere proceduren med databasenavnet og skemaet (dvs. msdb.dbo.sp_help_schedule ).

Eksempel

Her er et eksempel for at demonstrere, hvordan du returnerer alle tidsplaner i forekomsten:

EXEC msdb.dbo.sp_help_schedule;

Resultat:

Returner et skema baseret på dets navn

Du kan også få en tidsplan baseret på dens navn:

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

Returner et skema baseret på dets ID

Du kan alternativt få en tidsplan baseret på dens ID:

EXEC msdb.dbo.sp_help_schedule
	@schedule_id = 14;

Returnering kun vedhæftede skemaer

Selvom sp_help_schedule returnerer ikke tidsplaner for et specifikt job (brug sp_help_jobschedule til det), kan du bruge det til kun at returnere de tidsplaner, der er knyttet til et job.

Du kan gøre dette med @attached_schedules_only parameter.

@attached_schedules_only parameter er bit , med en standard på 0 , hvilket betyder, at den returnerer både vedhæftede og ikke-tilknyttede tidsplaner. Sender værdien 1 begrænser det til kun vedhæftede tidsplaner.

Eksempel:

EXEC sp_help_schedule
	@attached_schedules_only = 1;

Inkluder beskrivelsen

En anden ting, du kan gøre, er at angive, om du vil inkludere tidsplanens beskrivelse eller ej.

Som standard er beskrivelsen ikke inkluderet i resultatsættet. Faktisk er schedule_description kolonne er inkluderet, men den indeholder ikke beskrivelsen, medmindre du udtrykkeligt anmoder om det. Hvis du ikke anmoder om det, skal du bruge schedule_description kolonnen viser (Description not requested.) .

@include_description parameter er bit , med en standard på 0 , hvilket betyder, at den ikke viser beskrivelsen. Sender værdien 1 resulterer i, at beskrivelsen vises.

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