sp_help_schedule (Transact-SQL)

Restituisce un elenco di informazioni relative alle pianificazioni.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

sp_help_schedule 
     [ @schedule_id = ] id ,
     [ @schedule_name = ] 'schedule_name' 
     [ , [ @attached_schedules_only = ] attached_schedules_only ]
     [ , [ @include_description = ] include_description ]

Argomenti

  • [ @schedule_id = ] id
    Identificatore della pianificazione per cui restituire un elenco di informazioni. schedule_name è di tipo int e non prevede alcun valore predefinito. È possibile specificare l'argomento schedule_id o l'argomento schedule_name.

  • [ @schedule_name = ] 'schedule_name'
    Nome della pianificazione per cui restituire un elenco di informazioni. schedule_name è di tipo sysname e non prevede alcun valore predefinito. È possibile specificare l'argomento schedule_id o l'argomento schedule_name.

  • [ @attached_schedules_only = ] attached_schedules_only ]
    Specifica se visualizzare solo le pianificazioni a cui è associato un processo. attached_schedules_only è di tipo bit e il valore predefinito è 0. Quando il valore di attached_schedules_onlyè 0, vengono visualizzate tutte le pianificazioni. Quando il valore di attached_schedules_onlyè 1, il set dei risultati contiene solo le pianificazioni associate al processo.

  • [ @include_description = ] include_description
    Specifica se includere le descrizioni nel set dei risultati. include_description è di tipo bit e il valore predefinito è 0. Quando il valore di include_description è 0, la colonna schedule_description del set dei risultati contiene un segnaposto. 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

Questa procedura restituisce il set di risultati seguente:

Nome colonna

Tipo di dati

Descrizione

schedule_id

int

Numero di identificazione della pianificazione.

schedule_uid

uniqueidentifier

Identificatore 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 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, se richiesta.

job_count

int

Restituisce il numero di processi che fanno riferimento a questa pianificazione.

Osservazioni

Se non vengono specificati parametri, sp_help_schedule restituisce un elenco di informazioni relative a tutte le pianificazioni nell'istanza.

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 pianificazioni di cui sono proprietari.

Esempi

A. Visualizzazione di un elenco di informazioni per tutte le pianificazioni nell'istanza

Nell'esempio seguente viene visualizzato un elenco di informazioni per tutte le pianificazioni nell'istanza.

USE msdb ;
GO

EXEC dbo.sp_help_schedule ;
GO

B. Visualizzazione di un elenco di informazioni per una pianificazione specifica

Nell'esempio seguente viene visualizzato un elenco di informazioni per la pianificazione denominata NightlyJobs.

USE msdb ;
GO

EXEC dbo.sp_help_schedule
    @schedule_name = N'NightlyJobs' ;
GO