In SQL Server, il sp_help_schedule stored procedure restituisce informazioni sulle pianificazioni in SQL Server Agent.
Questo articolo fornisce una panoramica di questa stored procedure, inclusi esempi.
Sintassi
La sintassi ufficiale è questa:
sp_help_schedule
[ @schedule_id = ] id ,
[ @schedule_name = ] 'schedule_name'
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
Puoi chiamare sp_help_schedule , con o senza parametri.
Quando lo chiami senza alcun parametro, restituisce un elenco di tutte le pianificazioni nell'istanza.
Quando si passa il nome o l'ID di una pianificazione, viene restituito solo tale pianificazione.
Nota che sp_help_schedule si trova nel msdb database, quindi deve essere eseguito da lì. Puoi farlo passando a msdb database (ad es. con USE msdb ), oppure qualificando la procedura con il nome del database e lo schema (ad esempio msdb.dbo.sp_help_schedule ).
Esempio
Ecco un esempio per dimostrare come restituire tutte le pianificazioni nell'istanza:
EXEC msdb.dbo.sp_help_schedule;Risultato:
Restituire un programma in base al suo nome
Puoi anche ottenere un programma basato sul suo nome:
EXEC msdb.dbo.sp_help_schedule
@schedule_name = 'Weekly_Sun_3AM';Restituire un programma in base al suo ID
In alternativa puoi ottenere una pianificazione basata sul suo ID:
EXEC msdb.dbo.sp_help_schedule
@schedule_id = 14;Solo reso con orari allegati
Sebbene sp_help_schedule non restituisce le pianificazioni per un lavoro specifico (usa sp_help_jobschedule per questo), è possibile utilizzarlo per restituire solo le pianificazioni allegate a un lavoro.
Puoi farlo con @attached_schedules_only parametro.
Il @attached_schedules_only il parametro è bit , con un valore predefinito di 0 , il che significa che restituisce sia le pianificazioni allegate che non allegate. Passaggio di un valore di 1 lo limita solo agli orari allegati.
Esempio:
EXEC sp_help_schedule
@attached_schedules_only = 1;Includi la descrizione
Un'altra cosa che puoi fare è specificare se includere o meno la descrizione del programma.
Per impostazione predefinita, la descrizione non è inclusa nel set di risultati. In realtà, la schedule_description la colonna è incluso, ma non contiene la descrizione, a meno che tu non la richieda esplicitamente. Se non lo richiedi, la schedule_description la colonna mostra (Description not requested.) .
Il @include_description il parametro è bit , con un valore predefinito di 0 , il che significa che non mostra la descrizione. Passaggio di un valore di 1 comporta la visualizzazione della descrizione.
EXEC sp_help_jobschedule
@job_name = 'SqlAgentTest',
@include_description = 1;
