Прочитать на английском

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

sp_start_job (Transact-SQL)

  • Статья
  • 02.01.2025

Область применения: SQL Server Управляемый экземпляр SQL Azure

Указывает агент SQL Server немедленно выполнить задание.

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

Синтаксис

sp_start_job
    [ [ @job_name = ] N'job_name' ]
    [ , [ @job_id = ] 'job_id' ]
    [ , [ @error_flag = ] error_flag ]
    [ , [ @server_name = ] N'server_name' ]
    [ , [ @step_name = ] N'step_name' ]
    [ , [ @output_flag = ] output_flag ]
[ ; ]

Аргументы

[ @job_name = ] N'job_name'

Имя запускаемого задания. @job_name — sysname с значением по умолчаниюNULL.

Необходимо указать @job_id или @job_name, но их нельзя указать.

[ @job_id = ] 'job_id'

Идентификационный номер запускаемого задания. @job_id является уникальным идентификатором по умолчаниюNULL.

Необходимо указать @job_id или @job_name, но их нельзя указать.

[ @error_flag = ] error_flag

Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.

[ @server_name = ] N'server_name'

Имя целевого сервера, на котором запускается задание. @server_name — sysname с значением по умолчаниюNULL. @server_name должен быть одним из целевых серверов, на которые в настоящее время предназначено задание.

[ @step_name = ] N'step_name'

Имя этапа, с которого начинается выполнение задания. @step_name — sysname, значение по умолчанию NULL— sysname. Применяется только к локальным заданиям.

[ @output_flag = ] output_flag

Указано только в ознакомительных целях. Не поддерживается. Совместимость с будущими версиями не гарантируется.

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

0 (успешно) или 1 (сбой).

Результирующий набор

Нет.

Замечания

Эта хранимая процедура находится в msdb базе данных.

Эта хранимая процедура использует имя аналогичного sp_start_job объекта для службы заданий Elastic Azure для База данных SQL Azure. Сведения о версии эластичных заданий см. в разделе jobs.sp_start_job (задания эластичных баз данных Azure).

Вы можете предоставить EXECUTE разрешения для этой процедуры, но эти разрешения могут быть переопределены во время обновления SQL Server.

Другим пользователям необходимо предоставить одну из следующих агент 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

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

Дополнительные ресурсы