Share via

  • Статья

sp_start_job (Transact-SQL)

Отдает агенту SQL Server распоряжение выполнить задание немедленно.

Значок ссылки на разделСоглашения о синтаксическом обозначении в 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