sp_update_job (Transact-SQL)sp_update_job (Transact-SQL)

APLICA-SE A: simSQL Server nãoBanco de Dados SQL do Azure nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Altera os atributos de um trabalho.Changes the attributes of a job.

Ícone de link do tópico Convenções da sintaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

  
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 ]  

ArgumentosArguments

[ @job_id = ] job_idO número de identificação do trabalho a ser atualizado.[ @job_id = ] job_id The identification number of the job to be updated. job_idé uniqueidentifier.job_idis uniqueidentifier.

[ @job_name = ] 'job_name'O nome do trabalho.[ @job_name = ] 'job_name' The name of the job. job_name é nvarchar (128).job_name is nvarchar(128).

Observação: Job_id ou job_name deve ser especificado, mas ambos não podem ser especificados.NOTE: Either job_id or job_name must be specified but both cannot be specified.

[ @new_name = ] 'new_name'O novo nome para o trabalho.[ @new_name = ] 'new_name' The new name for the job. new_name é nvarchar (128).new_name is nvarchar(128).

[ @enabled = ] enabledEspecifica se o trabalho está habilitado (1) ou não está habilitado (0).[ @enabled = ] enabled Specifies whether the job is enabled (1) or not enabled (0). habilitado é tinyint.enabled is tinyint.

[ @description = ] 'description'A descrição do trabalho.[ @description = ] 'description' The description of the job. a Descrição é nvarchar (512).description is nvarchar(512).

[ @start_step_id = ] step_idO número de identificação da primeira etapa a ser executada para o trabalho.[ @start_step_id = ] step_id The identification number of the first step to execute for the job. step_id é int.step_id is int.

[ @category_name = ] 'category'A categoria do trabalho.[ @category_name = ] 'category' The category of the job. Category é nvarchar (128).category is nvarchar(128).

[ @owner_login_name = ] 'login'O nome do logon que possui o trabalho.[ @owner_login_name = ] 'login' The name of the login that owns the job. o logon é nvarchar (128) somente membros da função de servidor fixa sysadmin podem alterar a propriedade do trabalho.login is nvarchar(128) Only members of the sysadmin fixed server role can change job ownership.

[ @notify_level_eventlog = ] eventlog_levelEspecifica quando inserir uma entrada no log de aplicativos do Microsoft Windows para este trabalho.[ @notify_level_eventlog = ] eventlog_level Specifies when to place an entry in the Microsoft Windows application log for this job. eventlog_levelé inte pode ser um desses valores.eventlog_levelis int, and can be one of these values.

ValorValue Descrição (ação)Description (action)
00 NeverNever
11 Caso haja êxitoOn success
22 Caso haja falhaOn failure
Beta3 SempreAlways

[ @notify_level_email = ] email_levelEspecifica quando enviar um email após a conclusão deste trabalho.[ @notify_level_email = ] email_level Specifies when to send an e-mail upon the completion of this job. email_levelé int. email_levelusa os mesmos valores que eventlog_level.email_levelis int. email_leveluses the same values as eventlog_level.

[ @notify_level_netsend = ] netsend_levelEspecifica quando enviar uma mensagem de rede após a conclusão deste trabalho.[ @notify_level_netsend = ] netsend_level Specifies when to send a network message upon the completion of this job. netsend_levelé int. netsend_levelusa os mesmos valores que eventlog_level.netsend_levelis int. netsend_leveluses the same values as eventlog_level.

[ @notify_level_page = ] page_levelEspecifica quando enviar uma página após a conclusão deste trabalho.[ @notify_level_page = ] page_level Specifies when to send a page upon the completion of this job. page_level é int. page_levelusa os mesmos valores que eventlog_level.page_level is int. page_leveluses the same values as eventlog_level.

[ @notify_email_operator_name = ] 'operator_name'O nome do operador para o qual o email é enviado quando email_level é atingido.[ @notify_email_operator_name = ] 'operator_name' The name of the operator to whom the e-mail is sent when email_level is reached. email_name é nvarchar (128).email_name is nvarchar(128).

[ @notify_netsend_operator_name = ] 'netsend_operator'O nome do operador para o qual a mensagem de rede é enviada.[ @notify_netsend_operator_name = ] 'netsend_operator' The name of the operator to whom the network message is sent. netsend_operator é nvarchar (128).netsend_operator is nvarchar(128).

[ @notify_page_operator_name = ] 'page_operator'O nome do operador para o qual uma página é enviada.[ @notify_page_operator_name = ] 'page_operator' The name of the operator to whom a page is sent. page_operator é nvarchar (128).page_operator is nvarchar(128).

[ @delete_level = ] delete_levelEspecifica quando excluir o trabalho.[ @delete_level = ] delete_level Specifies when to delete the job. delete_valueé int. delete_levelusa os mesmos valores que eventlog_level.delete_valueis int. delete_leveluses the same values as eventlog_level.

[ @automatic_post = ] automatic_postReservado.[ @automatic_post = ] automatic_post Reserved.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

ComentáriosRemarks

sp_update_job deve ser executado do banco de dados msdb .sp_update_job must be run from the msdb database.

sp_update_job altera apenas as configurações para as quais os valores de parâmetro são fornecidos.sp_update_job changes only those settings for which parameter values are supplied. Se um parâmetro for omitido, a configuração atual será retida.If a parameter is omitted, the current setting is retained.

PermissõesPermissions

Por padrão, os membros da função de servidor fixa sysadmin podem executar esse procedimento armazenado.By default, members of the sysadmin fixed server role can execute this stored procedure. Deve ser concedida a outros usuários uma das seguintes funções de banco de dados fixas do SQL ServerSQL Server Agent no banco de dados msdb :Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

Somente os membros do sysadmin podem usar esse procedimento armazenado para editar os atributos de trabalhos que pertencem a outros usuários.Only members of sysadmin can use this stored procedure to edit the attributes of jobs that are owned by other users.

ExemplosExamples

O exemplo a seguir altera o nome, a descrição e o status habilitado do trabalho NightlyBackups.The following example changes the name, description, and enabled status of the job 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  

Consulte TambémSee Also

)(Transact-SQL de sp_add_job sp_add_job (Transact-SQL)
)(Transact-SQL de sp_delete_job sp_delete_job (Transact-SQL)
)(Transact-SQL de sp_help_job sp_help_job (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)System Stored Procedures (Transact-SQL)