sp_help_jobschedule (Transact-SQL)

Articolo
06/18/2013

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

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

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 è bit, con 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 è abilitata (1) o disabilitata (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 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

Vedere anche

Riferimento

sp_add_schedule (Transact-SQL)

sp_delete_schedule (Transact-SQL)

sp_update_schedule (Transact-SQL)

Stored procedure di sistema (Transact-SQL)

Condividi tramite