sp_help_jobschedule (Transact-SQL)

Articolo
12/15/2008

Restituisce informazioni sulla pianificazione dei processi utilizzati da SQL Server Management Studio per l'esecuzione di attività automatizzate.

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.

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)	Una 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	Conteggio dei processi restituiti.

[!NOTA] sp_help_jobschedule restituisce i valori dalle tabelle di sistema dbo.sysjobschedules e dbo.sysschedules in msdb. sysjobschedules effettua l'aggiornamento ogni 20 minuti. Questo può influire sui valori restituiti da questa 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

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 proprietà delle pianificazioni dei processi di cui sono proprietari.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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

Vedere anche

Riferimento

sp_add_schedule (Transact-SQL)
sp_delete_schedule (Transact-SQL)
sp_update_schedule (Transact-SQL)
Stored procedure di sistema (Transact-SQL)

Guida in linea e informazioni

Assistenza su SQL Server 2005

Condividi tramite