sp_start_job (Transact-SQL)
Отдает агенту SQL Server распоряжение немедленно выполнить задание.
Применимо для следующих объектов: SQL Server (начиная с SQL Server 2008 до текущей версии). |
.gif "Значок ссылки на раздел")
Cинтаксические обозначения в Transact-SQL
Синтаксис
sp_start_job
{ [@job_name =] 'job_name'
| [@job_id =] job_id }
[ , [@error_flag =] error_flag]
[ , [@server_name =] 'server_name']
[ , [@step_name =] 'step_name']
[ , [@output_flag =] output_flag]
Аргументы
[ @job_name= ] 'job_name'
Имя запускаемого задания. Необходимо указать либо аргумент job_id, либо аргумент job_name, но не оба аргумента одновременно. Аргумент job_name имеет тип sysname и значение по умолчанию NULL.[ @job_id= ] job_id
Идентификационный номер запускаемого задания. Необходимо указать либо аргумент job_id, либо аргумент job_name, но не оба аргумента одновременно. Аргумент job_id имеет тип uniqueidentifier и значение по умолчанию NULL.[ @error_flag= ] error_flag
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.[ @server_name= ] 'server_name'
Имя целевого сервера, на котором запускается задание. Аргумент server_name имеет тип nvarchar(128) и значение по умолчанию NULL. Аргумент server_name должен представлять один из целевых серверов, назначенных в данный момент для этого задания.[ @step_name= ] 'step_name'
Имя этапа, с которого начинается выполнение задания. Применяется только к локальным заданиям. Аргумент step_name имеет тип sysname и значение по умолчанию NULL.[ @output_flag= ] output_flag
Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.
Значения кода возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Результирующие наборы
Нет
Замечания
Эта хранимая процедура содержится в базе данных msdb.
Разрешения
По умолчанию эту хранимую процедуру могут выполнять члены предопределенной роли сервера sysadmin. Другим пользователям должна быть предоставлена одна из следующих предопределенных ролей базы данных агента SQL Server в базе данных msdb.
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
Дополнительные сведения о разрешениях для этих ролей см. в разделе Предопределенные роли базы данных агента SQL Server.
Членам ролей SQLAgentUserRole и SQLAgentReaderRole доступен запуск только тех заданий, которыми они владеют. Членам роли SQLAgentOperatorRole доступен запуск всех локальных заданий, включая находящиеся во владении других пользователей. Членам роли sysadmin доступен запуск всех локальных и многосерверных заданий.
Примеры
На следующем примере показано, как запускается задание с именем Weekly Sales Data Backup.
USE msdb ;
GO
EXEC dbo.sp_start_job N'Weekly Sales Data Backup' ;
GO