Partilhar via


jobs.sp_update_job (Azure Elastic Jobs) (Transact-SQL)

Aplica-se a: Banco de Dados SQL do Azure

Atualiza um trabalho criado no serviço de Trabalhos Elásticos do Azure para o Banco de Dados SQL do Azure.

Esse procedimento armazenado compartilha o nome de sp_update_job com um objeto semelhante no SQL Server para o serviço SQL Server Agent. Para obter informações sobre a versão do SQL Server Agent, consulte sp_update_job.

Convenções de sintaxe de Transact-SQL

Sintaxe

[jobs].sp_update_job [ @job_name = ] 'job_name'
  [ , [ @new_name = ] 'new_name' ]
  [ , [ @description = ] 'description' ]
  [ , [ @enabled = ] enabled ]
  [ , [ @schedule_interval_type = ] schedule_interval_type ]
  [ , [ @schedule_interval_count = ] schedule_interval_count ]
  [ , [ @schedule_start_time = ] schedule_start_time ]
  [ , [ @schedule_end_time = ] schedule_end_time ]

Argumentos

@job_name

O nome do trabalho a ser atualizado. job_name é nvarchar(128).

@new_name

O novo nome do trabalho. new_name é nvarchar(128).

@description

A descrição do trabalho. O argumento de descrição é nvarchar(512).

@enabled

Especifica se a agenda do trabalho está habilitada (1) ou não habilitada (0). @enabled é pouco.

@schedule_interval_type

O valor indica quando o trabalho será executado. schedule_interval_type é nvarchar(50) e pode ser um dos seguintes valores:

  • 'Once',
  • 'Minutes',
  • 'Hours',
  • 'Days',
  • 'Weeks',
  • 'Months'

@schedule_interval_count

Número de períodos de schedule_interval_count a ocorrer entre cada execução do trabalho. schedule_interval_count é int, com um padrão de 1. O valor precisa ser maior ou igual a 1.

@schedule_start_time

Data na qual a execução do trabalho pode começar. schedule_start_time é DATETIME2, com o padrão de 0001-01-01 00:00:00.0000000.

Todos os horários em trabalhos elásticos estão no fuso horário UTC.

@schedule_end_time

Data na qual a execução do trabalho pode parar. schedule_end_time é DATETIME2, com o padrão de 9999-12-31 11:59:59.0000000.

Todos os horários em trabalhos elásticos estão no fuso horário UTC.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

Depois jobs.sp_add_job de executado para adicionar um trabalho, use jobs.sp_add_jobstep para adicionar etapas que executam as atividades do trabalho.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Somente os membros da função sysadmin podem usar esse procedimento armazenado para editar os atributos dos trabalhos pertencentes a outros usuários.