sp_update_schedule (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Modifica le impostazioni per una pianificazione di SQL Server Agent.

Convenzioni di sintassi Transact-SQL

Sintassi

sp_update_schedule
    [ [ @schedule_id = ] schedule_id ]
    [ , [ @name = ] N'name' ]
    [ , [ @new_name = ] N'new_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 ]
    [ , [ @owner_login_name = ] N'owner_login_name' ]
    [ , [ @automatic_post = ] automatic_post ]
[ ; ]

Argomenti

[ @schedule_id = ] schedule_id

Identificatore della pianificazione da modificare. @schedule_id è int, con il valore predefinito NULL.

È necessario specificare @schedule_id o @name.

[ @name = ] N'name'

Nome della pianificazione da modificare. @name è sysname, con un valore predefinito .NULL

È necessario specificare @schedule_id o @name.

[ @new_name = ] N'new_name'

Nuovo nome della pianificazione. @new_name è sysname, con un valore predefinito .NULL Quando @new_name è NULL, il nome della pianificazione rimane invariato.

[ @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 non è abilitata, non verranno eseguiti processi in base a questa pianificazione.

[ @freq_type = ] freq_type

Valore che indica la frequenza di esecuzione di un processo @freq_type è int e può essere uno di questi valori.

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

[ @freq_interval = ] freq_interval

Giorni in cui un processo viene eseguito. @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 di un 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 di un 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ò essere arrestata. @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.

[ @owner_login_name = ] N'owner_login_name'

Nome dell'entità server proprietaria della pianificazione. @owner_login_name è sysname, con un valore predefinito NULL, che indica che la pianificazione è di proprietà dell'autore.

[ @automatic_post = ] automatic_post

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

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Osservazioni:

Tutti i processi che utilizzano la pianificazione, adottano immediatamente le nuove impostazioni. Tuttavia, la modifica di una pianificazione non arresta i processi attualmente in esecuzione.

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.

Solo i membri di sysadmin possono modificare una pianificazione di proprietà di un altro utente.

Esempi

Nell'esempio seguente viene modificato lo stato abilitato della pianificazione NightlyJobs impostandolo su 0 e impostando il proprietario su terrid.

USE msdb;
GO

EXEC dbo.sp_update_schedule
    @name = 'NightlyJobs',
    @enabled = 0,
    @owner_login_name = 'terrid';
GO

Contenuto correlato