sp_update_job (Transact-SQL)

Modifica gli attributi di un processo.

Convenzioni della sintassi Transact-SQL

Sintassi

sp_update_job [ @job_id =] job_id | [@job_name =] 'job_name'
     [, [@new_name =] 'new_name' ] 
     [, [@enabled =] enabled ]
     [, [@description =] 'description' ] 
     [, [@start_step_id =] step_id ]
     [, [@category_name =] 'category' ] 
     [, [@owner_login_name =] 'login' ]
     [, [@notify_level_eventlog =] eventlog_level ]
     [, [@notify_level_email =] email_level ]
     [, [@notify_level_netsend =] netsend_level ]
     [, [@notify_level_page =] page_level ]
     [, [@notify_email_operator_name =] 'operator_name' ]
     [, [@notify_netsend_operator_name =] 'netsend_operator' ]
     [, [@notify_page_operator_name =] 'page_operator' ]
     [, [@delete_level =] delete_level ] 
     [, [@automatic_post =] automatic_post ]

Argomenti

• [ @job_id =] job_id
  Numero di identificazione del processo da aggiornare. job_idè uniqueidentifier.

• [ @job_name =] 'job_name'
  Nome del processo. job_nameè nvarchar(128).

  [!NOTA]

  È necessario specificare l'argomento job_id oppure l'argomento job_name ma non è possibile specificarli entrambi.

• [ @new_name =] 'new_name'
  Nuovo nome del processo. new_nameè nvarchar(128).

• [ @enabled =] enabled
  Viene specificato se il processo è abilitato (1) o non abilitato (0). enabledè tinyint.

• [ @description =] 'description'
  Descrizione del processo. description è di tipo nvarchar(512).

• [ @start_step_id =] step_id
  Numero di identificazione del primo passaggio da eseguire per il processo. step_idè int.

• [ @category_name =] 'category'
  Categoria del processo. categoryè nvarchar(128).

• [ @owner_login_name =] 'login'
  Nome dell'account di accesso proprietario del processo. loginè di tipo nvarchar(128). Solo i membri del ruolo predefinito del server sysadmin possono modificare la proprietà dei processi.

• [ @notify_level_eventlog =] eventlog_level
  Viene specificato quando inserire una voce per il processo nel registro applicazioni di Microsoft Windows. eventlog_levelè di tipo int. I possibili valori sono i seguenti.

  Valore	Descrizione (azione)
  0	Never
  1	In caso di esito positivo
  2	In caso di esito negativo
  3	Always

• [ @notify_level_email =] email_level
  Viene specificato quando inviare un messaggio di posta elettronica al termine del processo. email_levelè int. email_levelconsente di utilizzare gli stessi valori di eventlog_level.

• [ @notify_level_netsend =] netsend_level
  Viene specificato quando inviare un messaggio di rete al termine del processo. netsend_levelè int. netsend_levelconsente di utilizzare gli stessi valori di eventlog_level.

• [ @notify_level_page =] page_level
  Viene specificato quando inviare una pagina al termine del processo. page_levelè int. page_levelconsente di utilizzare gli stessi valori di eventlog_level.

• [ @notify_email_operator_name =] 'email_name'
  Nome dell'operatore a cui viene inviato il messaggio di posta elettronica quando viene raggiunto email_level. email_name è di tipo nvarchar(128).

• [@notify_netsend_operator_name =] 'netsend_operator'
  Nome dell'operatore a cui viene inviato il messaggio di rete. netsend_operator è di tipo nvarchar(128).

• [ @notify_page_operator_name =] 'page_operator'
  Nome dell'operatore a cui viene inviata una pagina. page_operator è di tipo nvarchar(128).

• [ @delete_level =] delete_level
  Specifica quando eliminare il processo. delete_valueè int. delete_levelconsente di utilizzare gli stessi valori di eventlog_level.

• [ @automatic_post =] automatic_post
  Riservato.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

La stored procedure sp_update_job deve essere eseguita dal database msdb.

sp_update_job consente di modificare solo le impostazioni per le quali sono stati specificati valori di parametro. Se si omette un parametro, viene mantenuta l'impostazione corrente.

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.

Solo i membri di sysadmin possono utilizzare questa stored procedure per modificare gli attributi dei processi di proprietà di altri utenti.

Esempi

Nell'esempio seguente vengono modificati il nome, la descrizione e lo stato di attivazione del processo NightlyBackups.

USE msdb ;
GO

EXEC dbo.sp_update_job
    @job_name = N'NightlyBackups',
    @new_name = N'NightlyBackups -- Disabled',
    @description = N'Nightly backups disabled during server migration.',
    @enabled = 0 ;
GO

Vedere anche

Riferimento

sp_add_job (Transact-SQL)

sp_delete_job (Transact-SQL)

sp_help_job (Transact-SQL)

Stored procedure di sistema (Transact-SQL)