sp_update_job (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 =] 'email_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è di tipo uniqueidentifier.

• [ @job_name =] 'job_name'
  Nome del processo. job_name è di tipo 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 è di tipo nvarchar(128).

• [ @enabled =] enabled
  Specifica se il processo è attivato (1) o disattivato (0). enabledè di tipo 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è di tipo int.

• [ @category_name =] 'category'
  Categoria del processo. categoryè di tipo 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
  Specifica quando inserire una voce per il processo nel registro applicazioni di Microsoft Windows. eventlog_levelè di tipo int e i possibili valori sono i seguenti.

  Valore	Descrizione (azione)
  0	Mai
  1	In caso di esito positivo
  2	In caso di esito negativo
  3	Sempre

• [ @notify_level_email =] email_level
  Specifica quando inviare un messaggio di posta elettronica al termine del processo. email_levelè di tipo int. I possibili valori di email_levelcorrispondono a quelli di eventlog_level.

• [ @notify_level_netsend =] netsend_level
  Specifica quando inviare un messaggio di rete al termine del processo. netsend_levelè di tipo int. I possibili valori di netsend_levelcorrispondono a quelli di eventlog_level.

• [ @notify_level_page =] page_level
  Specifica quando inviare un messaggio su cercapersone al termine del processo. page_levelè di tipo int. I possibili valori di page_levelcorrispondono a quelli di eventlog_level.

• [ @notify_email_operator_name =] 'email_name'
  Nome di posta elettronica dell'operatore a cui viene inviato il messaggio di posta elettronica quando viene raggiunto il livello specificato in 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 inviato un messaggio su cercapersone. page_operator è di tipo nvarchar(128).

• [ @delete_level =] delete_level
  Specifica quando eliminare il processo. delete_valueè di tipo int. I possibili valori di delete_levelcorrispondono a quelli 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