• Articolo

sp_help_jobschedule (Transact-SQL)

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

Icona di collegamento a un argomentoConvenzioni 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 è 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.

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 è 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)

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