sp_update_job (Transact-SQL)

Altera os atributos de um trabalho.

Convenções da sintaxe 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 a job_id ou o job_name, mas não é possível especificar ambos ao mesmo tempo.

• [ @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 habilitado (0). enabledé 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'
  ID da categoria do trabalho. categoryé nvarchar(128).

• [ @owner_login_name =] 'login'
  O nome do logon que é o proprietário do trabalho. loginé nvarchar(128). Apenas 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 aplicativo do Microsoft Windows para este trabalho. eventlog_levelé int e pode ter um destes valores.

  Value	Descrição (ação)
  0	Never
  1	Caso haja êxito
  2	Caso haja falha
  3	Always

• [ @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 =] 'email_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 a 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
  Reservado.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_update_job deve ser executado a partir do banco de dados msdb.

sp_update_job altera somente essas configurações para as quais são fornecidos valores de parâmetro. 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 os membros de sysadmin podem usar este procedimento armazenado para editar os atributos de trabalhos que são de propriedade de 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

Referência

sp_add_job (Transact-SQL)

sp_delete_job (Transact-SQL)

sp_help_job (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)