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