sp_add_jobschedule (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 attuale della pianificazione. enabled_flag è di tipo tinyint e il valore predefinito è 1 (abilitata). 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 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 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)	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à 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 indicato da 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 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. 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 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.

• [ @schedule_uid= ] schedule_uidOUTPUT
  Identificatore univoco per la pianificazione. schedule_uid è una variabile di tipo uniqueidentifier.

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:

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

Vedere anche

Attivitá

Riferimento

Concetti