In SQL Server is de sp_help_schedule opgeslagen procedure retourneert informatie over schema's in de SQL Server Agent.
Dit artikel geeft een overzicht van deze opgeslagen procedure inclusief voorbeelden.
Syntaxis
De officiële syntaxis gaat als volgt:
sp_help_schedule
[ @schedule_id = ] id ,
[ @schedule_name = ] 'schedule_name'
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
Je kunt sp_help_schedule . bellen , met of zonder parameters.
Als je het zonder parameters aanroept, wordt een lijst met alle schema's in de instantie geretourneerd.
Als je een schemanaam of ID doorgeeft, wordt alleen dat schema geretourneerd.
Merk op dat sp_help_schedule bevindt zich in de msdb database, dus het moet vanaf daar worden uitgevoerd. U kunt dit doen door over te schakelen naar de msdb database (bijv. met USE msdb ), of door de procedure te kwalificeren met de databasenaam en het schema (d.w.z. msdb.dbo.sp_help_schedule ).
Voorbeeld
Hier is een voorbeeld om te demonstreren hoe u alle schema's in de instantie kunt retourneren:
EXEC msdb.dbo.sp_help_schedule;Resultaat:
Retourneer een schema op basis van zijn naam
Je kunt ook een schema krijgen op basis van de naam:
EXEC msdb.dbo.sp_help_schedule
@schedule_name = 'Weekly_Sun_3AM';Een schema retourneren op basis van zijn ID
U kunt ook een schema krijgen op basis van de ID:
EXEC msdb.dbo.sp_help_schedule
@schedule_id = 14;Alleen bijgevoegde schema's retourneren
Hoewel sp_help_schedule retourneert geen schema's voor een specifieke taak (gebruik sp_help_jobschedule daarvoor), kunt u het gebruiken om alleen die schema's te retourneren die aan een taak zijn gekoppeld.
U kunt dit doen met de @attached_schedules_only parameter.
De @attached_schedules_only parameter is bit , met een standaardwaarde van 0 , wat betekent dat het zowel gekoppelde als niet-bijgevoegde schema's retourneert. Een waarde van 1 doorgeven beperkt het tot alleen bijgevoegde schema's.
Voorbeeld:
EXEC sp_help_schedule
@attached_schedules_only = 1;Voeg de beschrijving toe
Een ander ding dat u kunt doen, is aangeven of u de beschrijving van het schema wel of niet wilt opnemen.
Standaard wordt de beschrijving niet opgenomen in de resultatenset. Eigenlijk is de schedule_description kolom is opgenomen, maar bevat niet de beschrijving, tenzij u hier expliciet om vraagt. Als je er niet om vraagt, de schedule_description kolom toont (Description not requested.) .
De @include_description parameter is bit , met een standaardwaarde van 0 , wat betekent dat de beschrijving niet wordt weergegeven. Een waarde van 1 doorgeven resulteert in de beschrijving die wordt weergegeven.
EXEC sp_help_jobschedule
@job_name = 'SqlAgentTest',
@include_description = 1;