sp_add_jobschedule (Transact-SQL)

Articolo
06/18/2013

Crea una pianificazione per un processo.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

sp_add_jobschedule [ @job_id = ] job_id, | [ @job_name = ] 'job_name', [ @name = ] 'name'
     [ , [ @enabled = ] enabled_flag ]
     [ , [ @freq_type = ] frequency_type ]
     [ , [ @freq_interval = ] frequency_interval ]
     [ , [ @freq_subday_type = ] frequency_subday_type ]
     [ , [ @freq_subday_interval = ] frequency_subday_interval ]
     [ , [ @freq_relative_interval = ] frequency_relative_interval ]
     [ , [ @freq_recurrence_factor = ] frequency_recurrence_factor ]
     [ , [ @active_start_date = ] active_start_date ]
     [ , [ @active_end_date = ] active_end_date ]
     [ , [ @active_start_time = ] active_start_time ]
     [ , [ @active_end_time = ] active_end_time ]
     [ , [ @schedule_id = ] schedule_id OUTPUT ]

Argomenti

[ @job_id= ] job_id
Numero di identificazione del processo a cui viene aggiunta la pianificazione. job_id è di tipo uniqueidentifier e non prevede alcun valore predefinito.
[ @job_name= ] 'job_name'
Nome del processo a cui viene aggiunta la pianificazione. job_name è di tipo nvarchar(128) e non prevede alcun valore predefinito.

[!NOTA]

È necessario specificare job_id o job_name, ma non è possibile specificarli entrambi.
[ @name= ] 'name'
Nome della pianificazione. name è di tipo nvarchar(128) e non prevede alcun valore predefinito.
[ @enabled= ] enabled_flag
Indica lo stato corrente della pianificazione. enabled_flag è di tipo tinyint e il valore predefinito è 1 (abilitato). Se il valore è 0, la pianificazione non è abilitata. Quando la pianificazione è disabilitata, il processo non viene eseguito.

[ @freq_type= ] frequency_type
Valore che indica la frequenza di esecuzione del processo. frequency_type è di tipo int e il valore predefinito è 0. I valori possibili sono i seguenti.

Valore	Descrizione
1	Una volta sola
4	Giornaliera
8	Settimanale
16	Mensile
32	Mensile, relativa a frequency_interval.
64	All'avvio del servizio SQL Server Agent
128	Quando il computer è inattivo

[ @freq_interval= ] frequency_interval
Giorno di esecuzione del processo. frequency_interval è di tipo int e il valore predefinito è 0. Dipende dal valore di frequency_type, come indicato nella tabella seguente:

Valore	Effetto
1 (una volta)	frequency_interval non viene utilizzato.
4 (giornaliera)	Ogni numero di giorni corrispondente a frequency_interval.
8 (settimanale)	frequency_interval corrisponde ad almeno uno dei valori seguenti combinati tramite l'operatore logico OR: 1 = domenica 2 = lunedì 4 = martedì 8 = mercoledì 16 = giovedì 32 = venerdì 64 = sabato
16 (mensile)	Il giorno del mese corrispondente a frequency_interval.
32 (frequenza mensile relativa)	frequency_interval corrisponde a uno dei valori seguenti: 1 = domenica 2 = lunedì 3 = martedì 4 = mercoledì 5 = giovedì 6 = venerdì 7 = sabato 8 = giorno 9 = giorno feriale 10 = giorno festivo
64 (all'avvio del servizio SQL Server Agent)	frequency_interval non viene utilizzato.
128	frequency_interval non viene utilizzato.

[ @freq_subday_type= ] frequency_subday_type
Specifica le unità per frequency_subday_interval. frequency_subday_type è di tipo int e non prevede alcun valore predefinito. I possibili valori sono i seguenti:

Valore

Descrizione (unità)

0x1

All'ora specificata

0x4

Minuti

0x8

Ore
[ @freq_subday_interval= ] frequency_subday_interval
Numero di periodi frequency_subday_type che devono intercorrere tra ogni esecuzione del processo. frequency_subday_interval è di tipo int e il valore predefinito è 0.
[ @freq_relative_interval= ] frequency_relative_interval
Definisce ulteriormente frequency_interval quando frequency_type è impostato su 32 (frequenza mensile relativa).

frequency_relative_interval è di tipo int e non prevede alcun valore predefinito. I possibili valori sono i seguenti:

Valore

Descrizione (unità)

1

Primo

2

Secondo

4

Terzo

8

Quarto

16

Ultimo

frequency_relative_interval indica l'occorrenza dell'intervallo. Se, ad esempio, frequency_relative_interval è impostato su 2, frequency_type è impostato su 32 e frequency_interval è impostato su 3, il processo pianificato verrà eseguito il secondo martedì di ogni mese.
[ @freq_recurrence_factor= ] frequency_recurrence_factor
Numero di settimane o mesi tra le esecuzioni pianificate del processo. frequency_recurrence_factor viene utilizzato solo se frequency_type è impostato su 8, 16 o 32. frequency_recurrence_factor è di tipo int e il valore predefinito è 0.
[ @active_start_date= ] active_start_date
Data in cui l'esecuzione del processo può avere inizio. active_start_date è di tipo int e non prevede alcun valore predefinito. La data è nel formato AAAAMMGG. Se active_start_date è impostato, la data deve essere maggiore o uguale a 19900101.

Al termine della creazione della pianificazione, esaminare la data di inizio per verificare che corrisponda alla data corretta. Per ulteriori informazioni, vedere la sezione relativa alla data di inizio della pianificazione in Creazione e collegamento di pianificazioni ai processi.
[ @active_end_date= ] active_end_date
Data in cui l'esecuzione del processo può essere arrestata. active_end_date è di tipo int e non prevede alcun valore predefinito. La data è nel formato AAAAMMGG.
[ @active_start_time= ] active_start_time
Data compresa tra active_start_date e active_end_date per l'inizio dell'esecuzione del processo. active_start_time è di tipo int e non prevede alcun valore predefinito. L'ora è in formato HHMMSS a 24 ore.
[ **@active_end_time=**active_end_time
Data compresa tra active_start_date e active_end_date per la fine dell'esecuzione del processo. active_end_time è di tipo int e non prevede alcun valore predefinito. L'ora è in formato HHMMSS a 24 ore.
[ @schedule_id=schedule_idOUTPUT
Numero di identificazione assegnato alla pianificazione dopo che è stata creata correttamente. schedule_id è una variabile di output di tipo int e non prevede alcun valore predefinito.
[ @schedule_uid= ] schedule_uidOUTPUT
Identificatore univoco della pianificazione. schedule_uid è una variabile di tipo uniqueidentifier.

Valore	Descrizione (unità)
0x1	All'ora specificata
0x4	Minuti
0x8	Ore

Valore	Descrizione (unità)
1	Primo
2	Secondo
4	Terzo
8	Quarto
16	Ultimo

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nessuno

Osservazioni

È possibile gestire le pianificazioni dei processi in modo indipendente dai processi. Per aggiungere una pianificazione a un processo, utilizzare sp_add_schedule per creare la pianificazione e quindi sp_attach_schedule per associare la pianificazione a un processo.

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: