sp_add_jobschedule (Transact-SQL)

Articolo
12/15/2008

Data aggiornamento: 17 novembre 2008

Crea una pianificazione per un processo.

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 l'argomento job_id oppure l'argomento 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 attuale della pianificazione. enabled_flag è di tipo tinyint e il valore predefinito è 1 (attivata). Se il valore è 0, la pianificazione non viene attivata. Quando la pianificazione è disattivata, 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 possibili valori sono i seguenti:

Valore	Descrizione
1	Una volta
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 frequency_interval giorni.
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 frequency_interval giorno del mese.
32 (mensile relativo)	I possibili valori di frequency_interval sono i 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à di 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

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

[ @freq_subday_interval= ] frequency_subday_interval
Numero di periodi indicato in 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 in maggiore dettaglio 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.

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

[ @freq_recurrence_factor= ] frequency_recurrence_factor
Numero di settimane o mesi che intercorrono 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. Il formato della data è YYYYMMDD. Se active_start_date è impostato, la data deve essere maggiore o uguale a 19900101.

Dopo aver creato la pianificazione, controllare la data di inizio per verificare che sia la data corretta desiderata. Per ulteriori informazioni, vedere la sezione relativa alla pianificazione della data di inizio in Creazione di pianificazioni.

[ @active_end_date= ] active_end_date
Data in cui l'esecuzione del processo può avere termine. active_end_date è di tipo int e non prevede alcun valore predefinito. Il formato della data è YYYYMMDD.

[ @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 il termine 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.

Set di risultati

Nessuno

Osservazioni

È ora 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:

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

Per informazioni sulle autorizzazioni di questi ruoli, vedere Ruoli di database predefiniti di SQL Server Agent.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Vedere anche

Cronologia modifiche

Versione	Cronologia
17 novembre 2008	Contenuto modificato: Aggiunta di informazioni su @ active_start_date.

Condividi tramite

sp_add_jobschedule (Transact-SQL)

Sintassi

Argomenti

Set di risultati

Osservazioni

Autorizzazioni

Valori restituiti

Vedere anche

Riferimento

Altre risorse

Guida in linea e informazioni

Cronologia modifiche

Risorse aggiuntive