sp_update_job (Transact-SQL)

  • Articolo

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

Aggiorna gli attributi di un processo esistente creato nel servizio SQL Server Agent.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_update_job
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @description = ] N'description' ]
    [ , [ @start_step_id = ] start_step_id ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @owner_login_name = ] N'owner_login_name' ]
    [ , [ @notify_level_eventlog = ] notify_level_eventlog ]
    [ , [ @notify_level_email = ] notify_level_email ]
    [ , [ @notify_level_netsend = ] notify_level_netsend ]
    [ , [ @notify_level_page = ] notify_level_page ]
    [ , [ @notify_email_operator_name = ] N'notify_email_operator_name' ]
    [ , [ @notify_netsend_operator_name = ] N'notify_netsend_operator_name' ]
    [ , [ @notify_page_operator_name = ] N'notify_page_operator_name' ]
    [ , [ @delete_level = ] delete_level ]
    [ , [ @automatic_post = ] automatic_post ]
[ ; ]

Argomenti

[ @job_id = ] 'job_id'

Numero di identificazione del processo da aggiornare. @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'

Il nome del processo. @job_name è sysname, con il valore predefinito NULL.

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

[ @new_name = ] N'new_name'

Nuovo nome del processo. @new_name è sysname, con un valore predefinito .NULL

[ @enabled = ] abilitato

Specifica se il processo è abilitato (1) o non abilitato (0). @enabled è tinyint, con un valore predefinito .NULL

[ @description = ] N'description'

Descrizione del processo. @description è nvarchar(512), con il valore predefinito NULL.

[ @start_step_id = ] start_step_id

Numero di identificazione del primo passaggio da eseguire per il processo. @start_step_id è int, con il valore predefinito NULL.

[ @category_name = ] N'category_name'

Categoria del processo. @category_name è sysname, con un valore predefinito .NULL

[ @owner_login_name = ] N'owner_login_name'

Nome dell'account di accesso proprietario del processo. @owner_login_name è sysname, con il valore predefinito NULL. Solo i membri del ruolo predefinito del server sysadmin possono modificare la proprietà del processo.

[ @notify_level_eventlog = ] notify_level_eventlog

Viene specificato quando inserire una voce per il processo nel registro applicazioni di Microsoft Windows. @notify_level_eventlog è int e può essere uno di questi valori.

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

[ @notify_level_email = ] notify_level_email

Viene specificato quando inviare un messaggio di posta elettronica al termine del processo. @notify_level_email è int, con il valore predefinito .NULL @notify_level_email usa gli stessi valori di @notify_level_eventlog.

[ @notify_level_netsend = ] notify_level_netsend

Viene specificato quando inviare un messaggio di rete al termine del processo. @notify_level_netsend è int, con il valore predefinito NULL. @notify_level_netsend usa gli stessi valori di @notify_level_eventlog.

[ @notify_level_page = ] notify_level_page

Viene specificato quando inviare una pagina al termine del processo. @notify_level_page è int, con un valore predefinito .NULL @notify_level_page usa gli stessi valori di @notify_level_eventlog.

[ @notify_email_operator_name = ] N'notify_email_operator_name'

Nome dell'operatore a cui viene inviato il messaggio di posta elettronica quando viene raggiunto email_level . @notify_email_operator_name è sysname, con un valore predefinito .NULL

[ @notify_netsend_operator_name = ] N'notify_netsend_operator_name'

Nome dell'operatore a cui viene inviato il messaggio di rete. @notify_netsend_operator_name è sysname, con un valore predefinito .NULL

[ @notify_page_operator_name = ] N'notify_page_operator_name'

Nome dell'operatore a cui viene inviata una pagina. @notify_page_operator_name è sysname, con un valore predefinito .NULL

[ @delete_level = ] delete_level

Specifica quando eliminare il processo. @delete_level è int, con il valore predefinito .NULL @delete_level usa gli stessi valori di @notify_level_eventlog.

[ @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:

sp_update_job deve essere eseguito dal msdb database.

sp_update_job modifica solo le impostazioni per le quali vengono specificati i valori dei parametri. Se si omette un parametro, viene mantenuta l'impostazione corrente.

Questa stored procedure condivide il nome di con un oggetto simile per il servizio Processi elastici di sp_update_job Azure per database SQL di Azure. Per informazioni sulla versione dei processi elastici, vedere jobs.sp_update_job (processi elastici di Azure).

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 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

Contenuto correlato