Dela via

sp_start_job (Transact-SQL)

gäller för:SQL ServerAzure SQL Managed Instance

Instruerar SQL Server Agent att omedelbart köra ett jobb.

Transact-SQL syntaxkonventioner

Syntax

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 ]
[ ; ]

Arguments

[ @job_name = ] N'job_name'

Namnet på jobbet för att börja med. @job_name är sysname, med standardvärdet .NULL

Antingen @job_id eller @job_name måste specificeras, men båda kan inte specificeras.

[ @job_id = ] 'job_id'

Identifieringsnumret för jobbet att börja med. @job_id är unik identifierare, med standardvärdet .NULL

Antingen @job_id eller @job_name måste specificeras, men båda kan inte specificeras.

[ @error_flag = ] error_flag

Identifieras endast i informationssyfte. Stöds inte. Framtida kompatibilitet garanteras inte.

[ @server_name = ] N'server_name'

Målservern där man ska starta jobbet. @server_name är sysname, med standardvärdet .NULL @server_name måste vara en av de målservrar som jobbet för närvarande riktas mot.

[ @step_name = ] N'step_name'

Namnet på steget där arbetet ska påbörjas. @step_name är sysname, med standardvärdet .NULL Gäller endast lokala jobb.

[ @output_flag = ] output_flag

Identifieras endast i informationssyfte. Stöds inte. Framtida kompatibilitet garanteras inte.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Ingen.

Anmärkningar

Den här lagrade proceduren finns i msdb databasen.

Denna lagrade propud delar namnet på sp_start_job med ett liknande objekt för Azure Elastic Jobs-tjänsten för Azure SQL Database. För information om elastic jobs-versionen, se jobs.sp_start_job (Azure Elastic Jobs).

Du kan ge EXECUTE behörigheter för denna procedur, men dessa behörigheter kan åsidosättas vid en SQL Server-uppgradering.

Andra användare måste tilldelas en av följande SQL Server Agent-fasta databasroller i databasen msdb :

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

För detaljer om behörigheterna för dessa roller, se SQL Server Agent Fixed Database Roles.

Medlemmar i SQLAgentUserRole och SQLAgentReaderRole kan endast starta jobb som de äger. Medlemmar i SQLAgentOperatorRole kan starta alla lokala jobb, inklusive jobb som ägs av andra användare. Medlemmar i systemadministratörer kan starta alla lokala och multiserverjobb.

Examples

Följande exempel startar ett jobb som heter Weekly Sales Data Backup.

USE msdb;
GO

EXECUTE dbo.sp_start_job N'Weekly Sales Data Backup';
GO

Relaterat innehåll

  • Last updated on