sp_help_schedule (Transact-SQL)
Restituisce un elenco di informazioni relative alle pianificazioni.
Sintassi
sp_help_schedule
[ @schedule_id = ] id ,
[ @schedule_name = ] 'schedule_name'
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
Argomenti
- [ @schedule_id = ] id
Identificatore della pianificazione per cui restituire un elenco di informazioni. schedule_name è di tipo int e non prevede alcun valore predefinito. È possibile specificare l'argomento schedule_id o l'argomento schedule_name.
- [ @schedule_name = ] 'schedule_name'
Nome della pianificazione per cui restituire un elenco di informazioni. schedule_name è di tipo sysname e non prevede alcun valore predefinito. È possibile specificare l'argomento schedule_id o l'argomento schedule_name.
- [ @attached_schedules_only = ] attached_schedules_only ]
Specifica se visualizzare solo le pianificazioni a cui è associato un processo. attached_schedules_only è di tipo bit e il valore predefinito è 0. Quando il valore di attached_schedules_onlyè 0, vengono visualizzate tutte le pianificazioni. Quando il valore di attached_schedules_onlyè 1, il set dei risultati contiene solo le pianificazioni associate al processo.
- [ @include_description = ] include_description
Specifica se includere le descrizioni nel set dei risultati. include_description è di tipo bit e il valore predefinito è 0. Quando il valore di include_description è 0, la colonna schedule_description del set dei risultati contiene un segnaposto. Quando il valore di include_description è 1, la descrizione della pianificazione è inclusa nel set dei risultati.
Set di risultati
Questa procedura restituisce il set di risultati seguente:
| Nome colonna | Tipo di dati | Descrizione |
|---|---|---|
schedule_id |
int |
Numero di identificazione della pianificazione. |
schedule_uid |
uniqueidentifier |
Identificatore 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 req_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, se richiesta. |
job_count |
int |
Restituisce il numero di processi che fanno riferimento a questa pianificazione. |
Osservazioni
Se non vengono specificati parametri, sp_help_schedule restituisce un elenco di informazioni relative a tutte le pianificazioni nell'istanza.
Autorizzazioni
Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del 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 pianificazioni di cui sono proprietari.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Esempi
A. Visualizzazione di un elenco di informazioni per tutte le pianificazioni nell'istanza
Nell'esempio seguente viene visualizzato un elenco di informazioni per tutte le pianificazioni nell'istanza.
USE msdb ;
GO
EXEC dbo.sp_help_schedule ;
GO
B. Visualizzazione di un elenco di informazioni per una pianificazione specifica
Nell'esempio seguente viene visualizzato un elenco di informazioni per la pianificazione denominata NightlyJobs.
USE msdb ;
GO
EXEC dbo.sp_help_schedule
@schedule_name = N'NightlyJobs' ;
GO
Vedere anche
Riferimento
sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)