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

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

Синтаксис

[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 могут использовать эту хранимую процедуру для редактирования атрибутов заданий, которыми владеют другие пользователи.

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