sp_update_job (Transact-SQL)

Aplica-se a:SQL Server

Altera os atributos de um trabalho.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
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 ]  

Argumentos

[ @job_id = ] job_id O número de identificação do trabalho a ser atualizado. job_idé uniqueidentifier.

[ @job_name = ] 'job_name' O nome do trabalho. job_name é nvarchar(128).

Observação

É necessário especificar job_id ou job_name , mas ambos não podem ser especificados.

[ @new_name = ] 'new_name' O novo nome do trabalho. new_name é nvarchar(128).

[ @enabled = ] enabled Especifica se o trabalho está habilitado (1) ou não (0). habilitado é tinyint.

[ @description = ] 'description' A descrição do trabalho. description é nvarchar(512).

[ @start_step_id = ] step_id O número de identificação da primeira etapa a ser executada para o trabalho. step_id é int.

[ @category_name = ] 'category' A categoria do trabalho. category é nvarchar(128).

[ @owner_login_name = ] 'login' O nome do logon que possui o trabalho. login é nvarchar(128) Somente membros da função de servidor fixa sysadmin podem alterar a propriedade do trabalho.

[ @notify_level_eventlog = ] eventlog_level Especifica quando colocar uma entrada no log de aplicativos do Microsoft Windows para esse trabalho. eventlog_levelé int e pode ser um desses valores.

Valor Descrição (ação)
0 Nunca
1 Caso haja êxito
2 Caso haja falha
3 Sempre

[ @notify_level_email = ] email_level Especifica quando enviar um email após a conclusão deste trabalho. email_levelé int. email_levelusa os mesmos valores que eventlog_level.

[ @notify_level_netsend = ] netsend_level Especifica quando enviar uma mensagem de rede após a conclusão deste trabalho. netsend_levelé int. netsend_levelusa os mesmos valores que eventlog_level.

[ @notify_level_page = ] page_level Especifica quando enviar uma página após a conclusão deste trabalho. page_level é int. page_levelusa os mesmos valores que eventlog_level.

[ @notify_email_operator_name = ] 'operator_name' O nome do operador para o qual o email é enviado quando email_level é atingido. email_name é nvarchar(128).

[ @notify_netsend_operator_name = ] 'netsend_operator' O nome do operador para o qual a mensagem de rede é enviada. netsend_operator é nvarchar(128).

[ @notify_page_operator_name = ] 'page_operator' O nome do operador para o qual uma página é enviada. page_operator é nvarchar(128).

[ @delete_level = ] delete_level Especifica quando excluir o trabalho. delete_valueé int. delete_levelusa os mesmos valores que eventlog_level.

[ @automatic_post = ] automatic_post Reservados.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_update_job deve ser executado no banco de dados msdb .

sp_update_job altera apenas as configurações para as quais os valores de parâmetro são fornecidos. Se um parâmetro for omitido, a configuração atual será retida.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários uma das seguintes funções de banco de dados fixas do SQL Server Agent no banco de dados msdb :

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

Somente membros do sysadmin podem usar esse procedimento armazenado para editar os atributos de trabalhos que pertencem a outros usuários.

Exemplos

O exemplo a seguir altera o nome, a descrição e o status habilitado do trabalho 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ém

sp_add_job (Transact-SQL)
sp_delete_job (Transact-SQL)
sp_help_job (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)