sp_help_jobschedule (Transact-SQL)

  • Articolo

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