sp_help_jobschedule (Transact-SQL)
Restituisce informazioni sulla pianificazione dei processi utilizzati da SQL Server Management Studio per l'esecuzione di attività automatizzate.
.gif "Icona di collegamento a un argomento")
Sintassi
sp_help_jobschedule { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
[ , [ @schedule_name = ] 'schedule_name' ]
[ , [ @schedule_id = ] schedule_id ]
[ , [ @include_description = ] include_description ]
Argomenti
[ @job_id= ] job_id
Numero di identificazione del processo. job_idè di tipo uniqueidentifier e il valore predefinito è NULL.[ @job_name= ] 'job_name'
Nome del processo. job_nameè di tipo sysname e il valore predefinito è NULL.[!NOTA]
È necessario specificare l'argomento job_id oppure l'argomento job_name ma non è possibile specificarli entrambi.
[ @schedule_name= ] 'schedule_name'
Nome dell'elemento di pianificazione per il processo. schedule_nameè di tipo sysname e il valore predefinito è NULL.[ @schedule_id= ] schedule_id
Numero di identificazione dell'elemento di pianificazione per il processo. schedule_idè di tipo int e il valore predefinito è NULL.[ @include_description= ] include_description
Specifica se includere la descrizione della pianificazione nel set dei risultati. include_description è di tipo bit e il valore predefinito è 0. Quando il valore di include_description è 0, la descrizione della pianificazione non è inclusa nel set dei risultati. Quando il valore di include_description è 1, la descrizione della pianificazione è inclusa nel set dei risultati.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Set di risultati
Nome colonna |
Tipo di dati |
Descrizione |
|---|---|---|
schedule_id |
int |
Numero di identificazione della pianificazione. |
schedule_name |
sysname |
Nome della pianificazione. |
enabled |
int |
Indica se la pianificazione è attivata (1) o disattivata (0). |
freq_type |
int |
Valore che indica la frequenza di esecuzione del processo. 1 = Una volta 4 = Giornaliera 8 = Settimanale 16 = Mensile 32 = Mensile basata su freq_interval 64 = All'avvio del servizio SQLServerAgent. |
freq_interval |
int |
Giorni in cui viene eseguito il processo. Il valore dipende da quello di freq_type. Per ulteriori informazioni, vedere sp_add_schedule (Transact-SQL). |
freq_subday_type |
int |
Unità per freq_subday_interval. Per ulteriori informazioni, vedere sp_add_schedule (Transact-SQL). |
freq_subday_interval |
int |
Numero di periodi freq_subday_type che devono intercorrere tra un'esecuzione del processo e la successiva. Per ulteriori informazioni, vedere sp_add_schedule (Transact-SQL). |
freq_relative_interval |
int |
Occorrenza di freq_interval al mese per il processo pianificato. Per ulteriori informazioni, vedere sp_add_schedule (Transact-SQL). |
freq_recurrence_factor |
int |
Numero di mesi tra l'esecuzione pianificata del processo. |
active_start_date |
int |
Data di attivazione della pianificazione. |
active_end_date |
int |
Data di fine della pianificazione. |
active_start_time |
int |
Ora di inizio della pianificazione. |
active_end_time |
int |
Ora di fine della pianificazione. |
date_created |
datetime |
Data di creazione della pianificazione. |
schedule_description |
nvarchar(4000) |
Descrizione in inglese della pianificazione derivata dai valori in msdb.dbo.sysschedules. Quando include_description è 0, questa colonna include un messaggio indicante che non era stata richiesta alcuna descrizione. |
next_run_date |
int |
Data della successiva esecuzione del processo in base alla pianificazione. |
next_run_time |
int |
Ora della successiva esecuzione del processo in base alla pianificazione. |
schedule_uid |
uniqueidentifier |
Identificatore della pianificazione. |
job_count |
int |
Numero di processi restituiti. |
[!NOTA]
sp_help_jobschedule restituisce valori dalle tabelle di sistema dbo.sysjobschedules e dbo.sysschedules in msdb. L'aggiornamento di sysjobschedules viene eseguito ogni 20 minuti. Ciò potrebbe influire sui valori restituiti dalla stored procedure.
Osservazioni
È possibile utilizzare i parametri di sp_help_jobschedule solo in determinate combinazioni. Se si specifica schedule_id, è necessario omettere sia job_id che job_name. In caso contrario, è possibile utilizzare i parametri job_id e job_name con schedule_name.
Autorizzazioni
È richiesta l'appartenenza al ruolo predefinito del server sysadmin. Gli altri utenti devono appartenere a uno dei seguenti ruoli predefiniti del database di SQL Server Agent nel database msdb:
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
Per informazioni sulle autorizzazioni di questi ruoli, vedere Ruoli di database predefiniti di SQL Server Agent.
I membri di SQLAgentUserRole possono visualizzare solo le proprietà delle pianificazioni dei processi di cui sono proprietari.
Esempi
A. Restituzione della pianificazione di un processo specifico
Nell'esempio seguente vengono restituite informazioni sulla pianificazione del processo BackupDatabase.
USE msdb ;
GO
EXEC dbo.sp_help_jobschedule
@job_name = N'BackupDatabase' ;
GO
B. Restituzione della pianificazione di un processo per una pianificazione specifica
Nell'esempio seguente vengono restituite informazioni sulla pianificazione NightlyJobs e sul processo RunReports.
USE msdb ;
GO
EXEC dbo.sp_help_jobschedule
@job_name = N'RunReports',
@schedule_name = N'NightlyJobs' ;
GO
C. Restituzione della pianificazione di un processo e della descrizione della pianificazione per una pianificazione specifica
Nell'esempio seguente vengono restituite informazioni sulla pianificazione NightlyJobs e sul processo RunReports. Il set dei risultati restituiti include una descrizione della pianificazione.
USE msdb ;
GO
EXEC dbo.sp_help_jobschedule
@job_name = N'RunReports',
@schedule_name = N'NightlyJobs',
@include_description = 1 ;
GO