Compartilhar via


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

Aplica-se a: Banco de Dados SQL do Azure

Adiciona um novo trabalho 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_add_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_add_job.

Convenções de sintaxe de Transact-SQL

Sintaxe

[jobs].sp_add_job [ @job_name = ] 'job_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 ]
  [ , [ @job_id = ] job_id OUTPUT ]

Argumentos

@job_name

O nome do trabalho. O nome deve ser exclusivo e não pode conter o caractere de porcentagem (%). job_name é nvarchar(128), sem padrão.

@description

A descrição do trabalho. description é nvarchar(512), com um padrão de NULL. Se description for omitido, uma cadeia de caracteres vazia será usada.

@enabled

Especifica se o agendamento do trabalho está habilitado. Habilitado é bit, com um padrão de 0 (desabilitado). Se 0, o trabalho não estiver habilitado e não for executado de acordo com sua programação; no entanto, ele poderá ser executado manualmente. Se 1, o trabalho será executado de acordo com sua programação e também poderá ser executado manualmente.

@schedule_interval_type

O valor indica quando o trabalho será executado. schedule_interval_type é nvarchar(50), com um padrão de Once, 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.

@job_id

O número de identificação atribuído ao trabalho caso ele seja criado com êxito. job_id é uma variável de saída do tipo uniqueidentifier.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

O procedimento jobs.sp_add_job armazenado deve ser executado a partir do banco de dados do agente de trabalho especificado ao criar o agente de trabalho.

Depois jobs.sp_add_job de executado para adicionar um trabalho, jobs.sp_add_jobstep pode ser usado para adicionar etapas que executam as atividades do trabalho. O número da versão inicial do trabalho é 0, que é incrementado para 1 quando a primeira etapa é adicionada.

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.