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 Azure Elastic Jobs 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 (Transact-SQL).
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 a descrição for omitida, uma cadeia de caracteres vazia será usada.
@enabled
Especifica se a agenda do trabalho está habilitada. 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 pode 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 (êxito) 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 ter sido executado para adicionar um trabalho, jobs.sp_add_jobstep pode ser usado para adicionar etapas que executam as atividades para o 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.
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de