sp_help_schedule (Transact-SQL)

Articolo
05/24/2023

Si applica a:SQL Server

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 da elencare. schedule_name è int, senza impostazione predefinita. È possibile specificare schedule_id o schedule_name .

[ @schedule_name = ] 'schedule_name' Nome della pianificazione da elencare. schedule_name è sysname, senza impostazione predefinita. È possibile specificare schedule_id o schedule_name .

[ @attached_schedules_only = ] attached_schedules_only ]Specifica se visualizzare solo le pianificazioni a cui è associato un processo. attached_schedules_only è bit, con un valore predefinito pari a 0. Quando attached_schedules_only è 0, vengono visualizzate tutte le pianificazioni. Quando attached_schedules_only è 1, il set di risultati contiene solo pianificazioni associate a un processo.

[ @include_description = ] include_description Specifica se includere descrizioni nel set di risultati. include_description è bit, con un valore predefinito pari a 0. Quando include_description è 0, la colonna schedule_description del set di risultati contiene un segnaposto. Quando include_description è 1, la descrizione della pianificazione viene inclusa nel set di risultati.

Valori del codice restituito

0 (esito positivo) o 1 (errore)

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.
abilitata	int	Indica se la pianificazione è abilitata (1) o meno abilitata (0).
freq_type	int	Valore che indica la frequenza di esecuzione del processo: 1 = Una volta 4 = Giornaliero 8 = Settimanale 16 = Mensile 32 = Mensile, rispetto al freq_interval 64 = Eseguire all'avvio del servizio SQLServerAgent.
freq_interval	int	Giorni in cui viene eseguito il processo. Il valore dipende dal valore di freq_type. Per altre informazioni, vedere sp_add_schedule (Transact-SQL).
freq_subday_type	int	Unità per freq_subday_interval. Per altre informazioni, vedere sp_add_schedule (Transact-SQL).
freq_subday_interval	int	Numero di periodi di freq_subday_type da eseguire tra ogni esecuzione del processo. Per altre informazioni, vedere sp_add_schedule (Transact-SQL).
freq_relative_interval	int	Occorrenza del processo pianificato del freq_interval in ogni mese. Per altre 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:

Quando non vengono forniti parametri, sp_help_schedule elenca le informazioni per tutte le pianificazioni nell'istanza di .

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 dettagliate 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

R. 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

Vedi anche

sp_add_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_detach_schedule (Transact-SQL)