Freigeben über


sp_start_job (Transact-SQL)

Weist den SQL Server-Agent an, einen Auftrag sofort auszuführen.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

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]

Argumente

  • [ @job_name= ] 'job_name'
    Der Name des Auftrags, der gestartet werden soll. Es muss entweder job_id oder job_name angegeben werden, beide Angaben sind jedoch nicht möglich. job_name ist vom Datentyp sysname. Der Standardwert ist NULL.

  • [ @job_id= ] job_id
    Die ID des Auftrags, der gestartet werden soll. Es muss entweder job_id oder job_name angegeben werden, beide Angaben sind jedoch nicht möglich. job_id ist vom Datentyp uniqueidentifier. Der Standardwert ist NULL.

  • [ @error_flag= ] error_flag
    Nur für Informationszwecke identifiziert. Nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

  • [ @server_name= ] 'server_name'
    Der Zielserver, auf dem der Auftrag gestartet werden soll. server_name ist vom Datentyp nvarchar(128). Der Standardwert ist NULL. server_name muss einer der gegenwärtigen Zielserver des Auftrags sein.

  • [ @step_name= ] 'step_name'
    Der Name des Schritts, mit dem die Ausführung des Auftrags beginnen soll. Gilt nur für lokale Aufträge. step_name ist vom Datentyp sysname. Der Standardwert ist NULL.

  • [ @output_flag= ] output_flag
    Nur für Informationszwecke identifiziert. Nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Keine

Hinweise

Diese gespeicherte Prozedur wird in der msdb-Datenbank gespeichert.

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Anderen Benutzern muss eine der folgenden festen Datenbankrollen des SQL Server-Agents in der msdb-Datenbank zugewiesen werden:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.

Mitglieder von SQLAgentUserRole und SQLAgentReaderRole können nur die Aufträge starten, deren Besitzer sie sind. Mitglieder von SQLAgentOperatorRole können alle lokalen Aufträge einschließlich der Aufträge starten, die sich im Besitz anderer Benutzer befinden. Mitglieder der sysadmin-Rolle können alle lokalen und Multiserveraufträge starten.

Beispiele

Im folgenden Beispiel wird ein Auftrag mit dem Namen Weekly Sales Data Backup gestartet.

USE msdb ;
GO

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

Siehe auch

Verweis

sp_delete_job (Transact-SQL)

sp_help_job (Transact-SQL)

sp_stop_job (Transact-SQL)

sp_update_job (Transact-SQL)

Gespeicherte Systemprozeduren (Transact-SQL)