I SQL Server, sp_help_schedule
lagrad procedur returnerar information om scheman i SQL Server Agent.
Den här artikeln ger en översikt över denna lagrade procedur inklusive exempel.
Syntax
Den officiella syntaxen ser ut så här:
sp_help_schedule
[ @schedule_id = ] id ,
[ @schedule_name = ] 'schedule_name'
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
Du kan ringa sp_help_schedule
, med eller utan parametrar.
När du anropar den utan några parametrar, returnerar den en lista över alla scheman i instansen.
När du passerar antingen ett schemanamn eller ID, returnerar det bara det schemat.
Observera att sp_help_schedule
finns i msdb databas, så den måste köras därifrån. Du kan göra detta antingen genom att byta till msdb databas (t.ex. med USE msdb
), eller genom att kvalificera proceduren med databasens namn och schema (dvs. msdb.dbo.sp_help_schedule
).
Exempel
Här är ett exempel för att visa hur du returnerar alla scheman i instansen:
EXEC msdb.dbo.sp_help_schedule;
Resultat:
Returnera ett schema baserat på dess namn
Du kan också få ett schema baserat på dess namn:
EXEC msdb.dbo.sp_help_schedule
@schedule_name = 'Weekly_Sun_3AM';
Returnera ett schema baserat på dess ID
Du kan alternativt få ett schema baserat på dess ID:
EXEC msdb.dbo.sp_help_schedule
@schedule_id = 14;
Returnering endast bifogade scheman
Även om sp_help_schedule
returnerar inte scheman för ett specifikt jobb (använd sp_help_jobschedule
för det), kan du använda den för att endast returnera de scheman som är kopplade till ett jobb.
Du kan göra detta med @attached_schedules_only
parameter.
@attached_schedules_only
parametern är bit , med standardvärdet 0
, vilket innebär att det returnerar både bifogade och obundna scheman. Skickar värdet 1
begränsar det till bara bifogade scheman.
Exempel:
EXEC sp_help_schedule
@attached_schedules_only = 1;
Inkludera beskrivningen
En annan sak du kan göra är att ange om schemats beskrivning ska inkluderas eller inte.
Som standard ingår inte beskrivningen i resultatuppsättningen. Faktiskt, schedule_description
kolumn är ingår, men den innehåller inte beskrivningen, såvida du inte uttryckligen begär det. Om du inte begär det, schedule_description
kolumnen visar (Description not requested.)
.
@include_description
parametern är bit , med standardvärdet 0
, vilket betyder att den inte visar beskrivningen. Skickar värdet 1
resulterar i att beskrivningen visas.
EXEC sp_help_jobschedule
@job_name = 'SqlAgentTest',
@include_description = 1;