sp_help_schedule (Transact-SQL)

Si applica a: SQL Server

Restituisce un elenco di informazioni relative alle pianificazioni.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_help_schedule
    [ [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @attached_schedules_only = ] attached_schedules_only ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Argomenti

[ @schedule_id = ] schedule_id

Identificatore della pianificazione per cui restituire un elenco di informazioni. @schedule_id è int, con il valore predefinito NULL.

È possibile specificare @schedule_id o @schedule_name .

[ @schedule_name = ] N'schedule_name'

Nome della pianificazione per cui restituire un elenco di informazioni. @schedule_name è sysname, con un valore predefinito .NULL

È possibile specificare @schedule_id o @schedule_name .

[ @attached_schedules_only = ] attached_schedules_only

Specifica se visualizzare solo le pianificazioni a cui è associato un processo. @attached_schedules_only è bit, con il valore predefinito .0 Quando @attached_schedules_only è 0, vengono visualizzate tutte le pianificazioni. Quando @attached_schedules_only è 1, il set di risultati contiene solo pianificazioni associate a un processo.

[ @include_description = ] include_description

Specifica se includere le descrizioni nel set dei risultati. @include_description è bit, con un valore predefinito .0 Quando @include_description è 0, la colonna @schedule_description del set di risultati contiene un segnaposto. Quando @include_description è 1, la descrizione della pianificazione viene inclusa nel set di risultati.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

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 è 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 SQLServerAgent.
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, se richiesta.
job_count int Restituisce il numero di processi che fanno riferimento a questa pianificazione.

Osservazioni:

Quando non vengono forniti parametri, sp_help_schedule elenca le informazioni per tutte le pianificazioni nell'istanza di .

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

Esempi

R. Elencare le 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. Elencare le 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