sp_help_schedule (Transact-SQL)
Restituisce un elenco di informazioni relative alle pianificazioni.
.gif "Icona di collegamento a un argomento")
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.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
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.
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