sp_update_job (Transact-SQL)

  • Articolo

Data aggiornamento: 5 dicembre 2005

Modifica gli attributi di un processo.

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). La proprietà dei processi può essere modificata solo da membri del ruolo predefinito del server sysadmin.

  • [ @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.

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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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)

Guida in linea e informazioni

Assistenza su SQL Server 2005

Cronologia modifiche

Versione Cronologia

5 dicembre 2005
Contenuto modificato
  • Aggiornamento del tipo di dati per gli argomenti @job_name, @new_name, @category_name, @owner_login_name, @notify_email_operator_name, @notify_netsend_operator_name e @notify_page_operator_name. Modifica da sysname a nvarchar().