sp_add_jobschedule (Transact-SQL)

Articolo
08/22/2024

Si applica a: SQL Server Istanza gestita di SQL di Azure

Crea una pianificazione per un processo di SQL Server Agent.

Convenzioni relative alla sintassi Transact-SQL

Importante

In Istanza gestita di SQL di Azure sono attualmente supportate la maggior parte delle funzionalità di SQL Server Agent, ma non tutte. Per informazioni dettagliate, vedere Differenze T-SQL tra Istanza gestita di SQL di Azure e SQL Server.

Sintassi

sp_add_jobschedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    , [ @name = ] N'name'
    [ , [ @enabled = ] enabled ]
    [ , [ @freq_type = ] freq_type ]
    [ , [ @freq_interval = ] freq_interval ]
    [ , [ @freq_subday_type = ] freq_subday_type ]
    [ , [ @freq_subday_interval = ] freq_subday_interval ]
    [ , [ @freq_relative_interval = ] freq_relative_interval ]
    [ , [ @freq_recurrence_factor = ] freq_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 ]
    [ , [ @automatic_post = ] automatic_post ]
    [ , [ @schedule_uid = ] 'schedule_uid' OUTPUT ]
[ ; ]

Argomenti

[ @job_id = ] 'job_id'

Numero di identificazione del processo a cui viene aggiunta la pianificazione. @job_id è uniqueidentifier, con un valore predefinito .NULL

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @job_name = ] N'job_name'

Nome del processo a cui viene aggiunta la pianificazione. @job_name è sysname, con il valore predefinito NULL.

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @name = ] N'name'

Nome della pianificazione. @name è sysname, senza impostazione predefinita.

[ @enabled = ] abilitato

Indica lo stato corrente della pianificazione. @enabled è tinyint, con il valore predefinito 1 (abilitato). Se 0, la pianificazione non è abilitata. Quando la pianificazione è disabilitata, il processo non viene eseguito.

[ @freq_type = ] freq_type

Valore che indica la frequenza di esecuzione del processo. @freq_type è int e può essere uno dei valori seguenti:

Valore	Descrizione
`1`	Una sola volta
`4`	Ogni giorno
`8`	Settimanale
`16`	Mensile
`32`	Mensile, rispetto alle @freq_interval.
`64`	Eseguire all'avvio del servizio SQL Server Agent.
`128`	Quando il computer è inattivo

[ @freq_interval = ] freq_interval

Giorno di esecuzione del processo. @freq_interval è int, con un valore predefinito , 0e dipende dal valore di @freq_type come indicato nella tabella seguente:

Valore di @freq_type	Effetto sulle @freq_interval
`1` (una volta)	@freq_interval non è usato.
`4` (giornaliero)	Ogni @freq_interval giorni.
`8` (settimanale)	@freq_interval è uno o più dei seguenti (combinati con un `OR` operatore logico): `1` = Domenica `2` = Lunedì `4` = Martedì `8` = Mercoledì `16` = Giovedì `32` = Venerdì `64` = Sabato
`16` (mensile)	Nel @freq_interval giorno del mese.
`32` (relativo mensile)	@freq_interval è uno dei seguenti: `1` = Domenica `2` = Lunedì `3` = Martedì `4` = Mercoledì `5` = Giovedì `6` = Venerdì `7` = Sabato `8` = Giorno `9` = Giorno feriale `10` = Giorno del fine settimana
`64` (all'avvio del servizio SQL Server Agent)	@freq_interval non è usato.
`128`	@freq_interval non è usato.

[ @freq_subday_type = ] freq_subday_type

Specifica le unità per @freq_subday_interval. @freq_subday_type è int e può essere uno di questi valori:

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

[ @freq_subday_interval = ] freq_subday_interval

Numero di periodi di @freq_subday_type da eseguire tra ogni esecuzione del processo. @freq_subday_interval è int, con il valore predefinito 0.

[ @freq_relative_interval = ] freq_relative_interval

Definisce ulteriormente il @freq_interval quando @freq_type è impostato su 32 (relativo mensile).

@freq_relative_interval è int e può essere uno di questi valori:

Valore	Descrizione (unità)
`1`	First
`2`	Secondo
`4`	Terza
`8`	Quarta
`16`	Last

@freq_relative_interval indica l'occorrenza dell'intervallo. Ad esempio, se @freq_relative_interval è impostato su 2, @freq_type è impostato su 32e @freq_interval è impostato su 3, il processo pianificato verrà eseguito il secondo martedì di ogni mese.

[ @freq_recurrence_factor = ] freq_recurrence_factor

Numero di settimane o mesi tra le esecuzioni pianificate del processo. @freq_recurrence_factor è int, con un valore predefinito .0 @freq_recurrence_factor viene usato solo se @freq_type è impostato su 8, 16o 32.

[ @active_start_date = ] active_start_date

Data di inizio dell'esecuzione del processo. @active_start_date è int, con un valore predefinito .NULL La data è formattata come yyyyMMdd. Se @active_start_date è impostato, la data deve essere maggiore o uguale a 19900101.

Dopo aver creato la pianificazione, esaminare la data di inizio e verificare che sia la data corretta. Per altre informazioni, vedere la sezione "Pianificazione della data di inizio" in Creare e allegare pianificazioni ai processi.

[ @active_end_date = ] active_end_date

Data in cui l'esecuzione del processo può interrompersi. @active_end_date è int, con un valore predefinito .99991231 La data è formattata come yyyyMMdd.

[ @active_start_time = ] active_start_time

Ora in qualsiasi giorno tra @active_start_date e @active_end_date per avviare l'esecuzione del processo. @active_start_time è int, con il valore predefinito 000000. L'ora viene formattata come HHmmss in un orologio di 24 ore.

[ @active_end_time = ] active_end_time

Ora in qualsiasi giorno tra active_start_date e @active_end_date per terminare l'esecuzione del processo. @active_end_time è int, con il valore predefinito .235959 L'ora viene formattata come HHmmss in un orologio di 24 ore.

[ @schedule_id = ] schedule_id OUTPUT

Pianificare il numero di identificazione assegnato alla pianificazione se viene creato correttamente. @schedule_id è un parametro OUTPUT di tipo int.

[ @automatic_post = ] automatic_post

Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.

[ @schedule_uid = ] OUTPUT 'schedule_uid'

Identificatore univoco della pianificazione. @schedule_uid è un parametro OUTPUT di tipo uniqueidentifier.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Nessuno.

Osservazioni:

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

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.

Esempi

Nell'esempio seguente viene assegnata una pianificazione del processo a SaturdayReports, che viene eseguita ogni sabato alle 2:00.

EXEC msdb.dbo.sp_add_jobschedule
    @job_name = N'SaturdayReports', -- Job name
    @name = N'Weekly_Sat_2AM', -- Schedule name
    @freq_type = 8, -- Weekly
    @freq_interval = 64, -- Saturday
    @freq_recurrence_factor = 1, -- every week
    @active_start_time = 20000 -- 2:00 AM

Condividi tramite

sp_add_jobschedule (Transact-SQL)

Sintassi

Argomenti

[ @job_id = ] 'job_id'

[ @job_name = ] N'job_name'

[ @name = ] N'name'

[ @enabled = ] abilitato

[ @freq_type = ] freq_type

[ @freq_interval = ] freq_interval

[ @freq_subday_type = ] freq_subday_type

[ @freq_subday_interval = ] freq_subday_interval

[ @freq_relative_interval = ] freq_relative_interval

[ @freq_recurrence_factor = ] freq_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

[ @automatic_post = ] automatic_post

[ @schedule_uid = ] OUTPUT 'schedule_uid'

Valori del codice restituito

Set di risultati

Osservazioni:

Autorizzazioni

Esempi

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

sp_add_jobschedule (Transact-SQL)

Sintassi

Argomenti

[ @job_id = ] 'job_id'

[ @job_name = ] N'job_name'

[ @name = ] N'name'

[ @enabled = ] abilitato

[ @freq_type = ] freq_type

[ @freq_interval = ] freq_interval

[ @freq_subday_type = ] freq_subday_type

[ @freq_subday_interval = ] freq_subday_interval

[ @freq_relative_interval = ] freq_relative_interval

[ @freq_recurrence_factor = ] freq_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

[ @automatic_post = ] automatic_post

[ @schedule_uid = ] OUTPUT 'schedule_uid'

Valori del codice restituito

Set di risultati

Osservazioni:

Autorizzazioni

Esempi

Contenuto correlato

Commenti e suggerimenti

Risorse aggiuntive