Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
SQL ServerAzure SQL Managed Instance
Atualiza os atributos de um trabalho existente criado no serviço SQL Server Agent.
Transact-SQL convenções de sintaxe
Sintaxe
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 ]
[ ; ]
Arguments
[ @job_id = ] 'job_id'
O número de identificação do trabalho a atualizar.
@job_id é um identificador único, com um padrão de NULL.
Ou @job_id ou @job_name devem ser especificados, mas nenhum dos dois pode ser especificado.
[ @job_name = ] N'job_name'
O nome da tarefa.
@job_name é sysname, com o padrão de NULL.
Ou @job_id ou @job_name devem ser especificados, mas nenhum dos dois pode ser especificado.
[ @new_name = ] N'new_name'
O novo nome para o cargo.
@new_name é sysname, com um padrão de NULL.
[ @enabled = ] ativado
Especifica se o trabalho está ativado (1) ou não (0).
@enabled é tinyint, com um padrão de NULL.
[ @description = ] N'descrição'
A descrição do trabalho.
@description é nvarchar(512), com um padrão de NULL.
[ @start_step_id = ] start_step_id
O número de identificação do primeiro passo a executar para o trabalho.
@start_step_id é int, com um padrão de NULL.
[ @category_name = ] N'category_name'
A categoria da tarefa.
@category_name é sysname, com um padrão de NULL.
[ @owner_login_name = ] N'owner_login_name'
O nome do utilizador que detém o trabalho.
@owner_login_name é sysname, com o padrão de NULL. Só os membros do papel fixo de sysadmin no servidor podem mudar a propriedade do trabalho.
[ @notify_level_eventlog = ] notify_level_eventlog
Especifica quando colocar uma entrada no registo de aplicações do Microsoft Windows para este trabalho. @notify_level_eventlog é int, e pode ser um desses valores.
| Valor | Descrição (ação) |
|---|---|
0 |
Nunca |
1 |
Sobre o sucesso |
2 |
Sobre o fracasso |
3 |
Sempre |
[ @notify_level_email = ] notify_level_email
Especifica quando enviar um e-mail após a conclusão deste trabalho.
@notify_level_email é int, com um padrão de NULL.
@notify_level_email usa os mesmos valores que @notify_level_eventlog.
[ @notify_level_netsend = ] notify_level_netsend
Especifica quando enviar uma mensagem de rede após a conclusão deste trabalho.
@notify_level_netsend é int, com um padrão de NULL.
@notify_level_netsend usa os mesmos valores que @notify_level_eventlog.
[ @notify_level_page = ] notify_level_page
Especifica quando enviar uma página após a conclusão deste trabalho.
@notify_level_page é int, com um padrão de NULL.
@notify_level_page usa os mesmos valores que @notify_level_eventlog.
[ @notify_email_operator_name = ] N'notify_email_operator_name'
O nome do operador a quem o e-mail é enviado quando email_level é alcançado.
@notify_email_operator_name é sysname, com um padrão de NULL.
[ @notify_netsend_operator_name = ] N'notify_netsend_operator_name'
O nome do operador a quem a mensagem de rede é enviada.
@notify_netsend_operator_name é sysname, com um padrão de NULL.
[ @notify_page_operator_name = ] N'notify_page_operator_name'
O nome do operador a quem uma página é enviada.
@notify_page_operator_name é sysname, com um padrão de NULL.
[ @delete_level = ] delete_level
Especifica quando eliminar o trabalho.
@delete_level é int, com um padrão de NULL.
@delete_level usa os mesmos valores que @notify_level_eventlog.
[ @automatic_post = ] automatic_post
Identificado apenas para fins informativos. Não suportado. A compatibilidade futura não é garantida.
Valores de código de retorno
0 (sucesso) ou 1 (fracasso).
Observações
sp_update_job deve ser executado a partir da msdb base de dados.
sp_update_job altera apenas as definições para as quais os valores dos parâmetros são fornecidos. Se um parâmetro for omitido, a configuração atual é mantida.
Este procedimento armazenado partilha o nome de sp_update_job com um objeto semelhante para o serviço Azure Elastic Jobs para Azure SQL Database. Para informações sobre a versão do Elastic Jobs, consulte jobs.sp_update_job (Azure Elastic Jobs).
Permissions
Pode conceder EXECUTE permissões neste procedimento, mas essas permissões podem ser anuladas durante uma atualização do SQL Server.
Outros utilizadores devem receber um dos seguintes papéis fixos de base de dados SQL Server Agent na msdb base de dados:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Para detalhes sobre as permissões destes papéis, consulte Funções de Base de Dados Fixas do Agente SQL Server.
Apenas os membros do sysadmin podem usar este procedimento armazenado para editar os atributos de trabalhos que pertencem a outros utilizadores.
Examples
O exemplo seguinte altera o nome, a descrição e o estado habilitado do trabalho NightlyBackups.
USE msdb;
GO
EXECUTE dbo.sp_update_job
@job_name = N'NightlyBackups',
@new_name = N'NightlyBackups -- Disabled',
@description = N'Nightly backups disabled during server migration.',
@enabled = 0;
GO