sp_start_job (Transact-SQL)sp_start_job (Transact-SQL)

DIESES THEMA GILT FÜR:jaSQL Server (ab 2008)neinAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Weist den SQL ServerSQL Server-Agent an, einen Auftrag sofort auszuführen.Instructs SQL ServerSQL Server Agent to execute a job immediately.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax


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]  

ArgumenteArguments

[ @job_name= ] "Job_name"[ @job_name= ] 'job_name'
Der Name des Auftrags, der gestartet werden soll.The name of the job to start. Entweder Job_id oder Job_name muss angegeben werden, aber beide können nicht angegeben werden.Either job_id or job_name must be specified, but both cannot be specified. Job_name ist Sysname, hat den Standardwert NULL.job_name is sysname, with a default of NULL.

[ @job_id= ] job_id[ @job_id= ] job_id
Die ID des Auftrags, der gestartet werden soll.The identification number of the job to start. Entweder Job_id oder Job_name muss angegeben werden, aber beide können nicht angegeben werden.Either job_id or job_name must be specified, but both cannot be specified. Job_id ist "uniqueidentifier", hat den Standardwert NULL.job_id is uniqueidentifier, with a default of NULL.

[ @error_flag= ] error_flag[ @error_flag= ] error_flag
Nur für Informationszwecke identifiziert.Identified for informational purposes only. Wird nicht unterstützt.Not supported. Künftige Kompatibilität wird nicht garantiert.Future compatibility is not guaranteed.

[ @server_name= ] "Server_name"[ @server_name= ] 'server_name'
Der Zielserver, auf dem der Auftrag gestartet werden soll.The target server on which to start the job. Server_name ist vom Datentyp nvarchar(128), hat den Standardwert NULL.server_name is nvarchar(128), with a default of NULL. Server_name muss eines der Zielserver, dem der Auftrag derzeit gerichtet, sein.server_name must be one of the target servers to which the job is currently targeted.

[ @step_name= ] "Step_name"[ @step_name= ] 'step_name'
Der Name des Schritts, mit dem die Ausführung des Auftrags beginnen soll.The name of the step at which to begin execution of the job. Gilt nur für lokale Aufträge.Applies only to local jobs. Step_name ist Sysname, hat den Standardwert NULLstep_name is sysname, with a default of NULL

[ @output_flag= ] Output_flag[ @output_flag= ] output_flag
Nur für Informationszwecke identifiziert.Identified for informational purposes only. Wird nicht unterstützt.Not supported. Künftige Kompatibilität wird nicht garantiert.Future compatibility is not guaranteed.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

ResultsetsResult Sets

KeineNone

HinweiseRemarks

Diese gespeicherte Prozedur wird in der msdb -Datenbank gespeichert.This stored procedure is in the msdb database.

BerechtigungenPermissions

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen.By default, members of the sysadmin fixed server role can execute this stored procedure. Andere Benutzer müssen Mitglieder der festen SQL ServerSQL Server -Agent-Datenbankrollen in der msdb -Datenbank sein:Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

    Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

    Mitglieder der SQLAgentUserRole und SQLAgentReaderRole können nur Aufträge, deren Besitzer sie, starten.Members of SQLAgentUserRole and SQLAgentReaderRole can only start jobs that they own. Mitglieder der SQLAgentOperatorRole können alle lokalen Aufträge einschließlich derjenigen, die von anderen Benutzern gehören starten.Members of SQLAgentOperatorRole can start all local jobs including those that are owned by other users. Mitglieder der Sysadmin können Aufträge für alle lokalen und Multiserveraufträge starten.Members of sysadmin can start all local and multiserver jobs.

BeispieleExamples

Im folgenden Beispiel wird ein Auftrag mit dem Namen Weekly Sales Data Backup gestartet.The following example starts a job named Weekly Sales Data Backup.

USE msdb ;  
GO  

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

Siehe auchSee Also

sp_delete_job (Transact-SQL) sp_delete_job (Transact-SQL)
sp_help_job (Transact-SQL) sp_help_job (Transact-SQL)
sp_stop_job (Transact-SQL) sp_stop_job (Transact-SQL)
sp_update_job (Transact-SQL) sp_update_job (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)System Stored Procedures (Transact-SQL)