sp_help_jobschedule (Transact-SQL)

Si applica a: SQL Server

Restituisce informazioni sulla pianificazione dei processi usati da SQL Server Management Studio per eseguire attività automatizzate.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_help_jobschedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Argomenti

[ @job_id = ] 'job_id'

Numero di identificazione del processo. @job_id è uniqueidentifier, con un valore predefinito .NULL

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @job_name = ] N'job_name'

Il nome del processo. @job_name è sysname, con il valore predefinito NULL.

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @schedule_name = ] N'schedule_name'

Nome dell'elemento di pianificazione per il processo. @schedule_name è sysname, con un valore predefinito .NULL

[ @schedule_id = ] schedule_id

Numero di identificazione dell'elemento di pianificazione per il processo. @schedule_id è int, con il valore predefinito NULL.

[ @include_description = ] include_description

Specifica se includere la descrizione della pianificazione nel set dei risultati. @include_description è bit, con un valore predefinito .0

  • Quando 0, la descrizione della pianificazione non è inclusa nel set di risultati.
  • Quando 1, la descrizione della pianificazione viene inclusa nel set di risultati.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

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 () o meno (10).
freq_type int Valore che indica la frequenza di esecuzione del processo:

1 = Una volta
4 = Giornaliero
8 = Settimanale
16 = Mensile
32 = Mensile, relativo all'oggetto freq_interval
64 = Eseguire all'avvio del servizio SQL Server Agent.
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.
freq_subday_type int Unità per freq_subday_interval. Per altre informazioni, vedere sp_add_schedule.
freq_subday_interval int Numero di freq_subday_type periodi che devono verificarsi tra ogni esecuzione del processo. Per altre informazioni, vedere sp_add_schedule.
freq_relative_interval int Occorrenza del processo pianificato di freq_interval in ogni mese. Per altre informazioni, vedere sp_add_schedule.
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 contiene testo che indica che la descrizione non è stata richiesta.
next_run_date int Data in cui la pianificazione successiva determina l'esecuzione del processo.
next_run_time int Ora in cui la pianificazione successiva determina l'esecuzione del processo.
schedule_uid uniqueidentifier Identificatore della pianificazione.
job_count int Numero di processi restituiti.

Nota

sp_help_jobschedule restituisce i valori delle tabelle di dbo.sysjobschedules sistema e dbo.sysschedules negli msdb.sysjobschedules aggiornamenti ogni 20 minuti. Ciò potrebbe influire sui valori restituiti dalla stored procedure.

Osservazioni:

I parametri di sp_help_jobschedule possono essere usati solo in determinate combinazioni. Se si specifica @schedule_id , non è possibile specificare @job_id e @job_name . In caso contrario, i parametri @job_id o @job_name possono essere usati con @schedule_name.

Autorizzazioni

Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono essere sottoposte a override durante un aggiornamento di SQL Server.

È necessario concedere ad altri utenti uno dei ruoli predefiniti del database di SQL Server Agent seguenti: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 proprietà delle pianificazioni dei processi di cui sono proprietari.

Esempi

R. Restituire la pianificazione del processo per 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. Restituire la pianificazione del 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. Restituisce la pianificazione del processo e la 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