Поделиться через

jobs.sp_add_job (задания эластичных баз данных Azure) (Transact-SQL)

  • Статья

Применимо к: База данных SQL Azure

Добавляет новое задание в службу заданий Эластичных баз данных Azure для База данных SQL Azure.

Эта хранимая процедура использует имя аналогичного sp_add_job объекта в SQL Server для службы агент SQL Server. Сведения о версии агент SQL Server см. в sp_add_job (Transact-SQL).

Соглашения о синтаксисе Transact-SQL

Синтаксис

[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 ]

Аргументы

@job_name

Имя задания. Имя должно быть уникальным и не может содержать символ процента (%). job_name — nvarchar(128), без значения по умолчанию.

@description

Описание задания. description — nvarchar(512) с значением по умолчанию NULL. Если описание опущено, используется пустая строка.

@enabled

Указывает, включена ли расписание задания. Включен бит с значением по умолчанию 0 (отключено). Если 0задание не включено и не выполняется в соответствии с расписанием. Однако его можно запустить вручную. Если 1задание будет выполняться в соответствии с расписанием, а также может выполняться вручную.

@schedule_interval_type

Это значение указывает, когда должно выполняться задание. schedule_interval_type — nvarchar(50), по умолчанию Onceи может быть одним из следующих значений:

  • Once
  • Minutes
  • Hours
  • Days
  • Weeks
  • Months

@schedule_interval_count

Количество schedule_interval_count периодов между каждым выполнением задания. schedule_interval_count имеет значение int с значением по умолчанию1. Это значение должно быть больше или равно 1.

@schedule_start_time

Дата, когда может начаться выполнение задания. schedule_start_time DATETIME2 с значением по умолчанию 0001-01-01 00:00:00.0000000.

Все время в эластичных заданиях находятся в часовом поясе UTC.

@schedule_end_time

Дата, когда может быть остановлено выполнение задания. schedule_end_time DATETIME2 с значением по умолчанию 9999-12-31 11:59:59.00000000.

Все время в эластичных заданиях находятся в часовом поясе UTC.

@job_id

Идентификационный номер задания, присваиваемый заданию после успешного создания. job_id — выходная переменная типа uniqueidentifier.

Значения кода возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Замечания

Хранимая процедура jobs.sp_add_job должна выполняться из базы данных агента задания, указанной при создании агента задания.

После jobs.sp_add_job выполнения добавления задания jobs.sp_add_jobstep можно использовать для добавления шагов, выполняющих действия для задания. Начальный номер версии задания , 0который увеличивается до 1 момента добавления первого шага.

Разрешения

По умолчанию участники фиксированной роли сервера sysadmin могут выполнять эту хранимую процедуру. Только участники роли sysadmin могут использовать эту хранимую процедуру для редактирования атрибутов заданий, которыми владеют другие пользователи.

Связанный контент