Freigeben über


sp_help_jobstep (Transact-SQL)

Gibt Informationen zu den Schritten eines Auftrags zurück, die der SQL Server-Agent-Dienst verwendet, um automatisierte Aktivitäten auszuführen.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

sp_help_jobstep { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }
     [ , [ @step_id = ] step_id ] 
     [ , [ @step_name = ] 'step_name' ] 
     [ , [ @suffix = ] suffix ] 

Argumente

  • [ @job_id =] 'job_id'
    Die ID des Auftrags, zu dem Auftragsinformationen zurückgegeben werden sollen. job_id ist vom Datentyp uniqueidentifier. Der Standardwert ist NULL.

  • [ @job_name =] 'job_name'
    Der Name des Auftrags. job_name ist vom Datentyp sysname. Der Standardwert ist NULL.

    HinweisHinweis

    Es muss entweder job_id oder job_name angegeben werden, beide Angaben sind jedoch nicht möglich.

  • [ @step_id =] step_id
    Die ID des Auftragsschritts. Wenn diese nicht angegeben wird, sind alle Schritte im Auftrag eingeschlossen. step_id ist vom Datentyp int. Der Standardwert ist NULL.

  • [ @step_name =] 'step_name'
    Der Name des Schritts im Auftrag. step_name ist vom Datentyp sysname. Der Standardwert ist NULL.

  • [ @suffix =] suffix
    Ein Flag, das angibt, oder der Spalte Flags in der Ausgabe eine Textbeschreibung angefügt werden soll. suffixist vom Datentyp bit. Der Standardwert ist 0. Wenn suffix den Wert 1 aufweist, wird eine Beschreibung angefügt.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Spaltenname

Datentyp

Beschreibung

step_id

int

Eindeutiger Bezeichner für den Schritt.

step_name

sysname

Name des Auftragsschritts.

subsystem

nvarchar(40)

Subsystem, in dem der Schrittbefehl ausgeführt werden soll.

command

nvarchar(max)

Befehl, der in dem Schritt ausgeführt wird.

flags

int

Bitmaske der Werte, die das Schrittverhalten steuern.

cmdexec_success_code

int

Bei einem CmdExec-Schritt ist dies der Prozessexitcode eines erfolgreichen Befehls.

on_success_action

tinyint

Auszuführende Aktion, wenn der Schritt erfolgreich ist:

1 = Auftrag mit Erfolgsmeldung beenden.

2 = Auftrag mit Fehlermeldung beenden.

3 = Zum nächsten Schritt wechseln.

4 = Zu einem angegebenen Schritt wechseln.

on_success_step_id

int

Wenn on_success_action den Wert 4 aufweist, wird hiermit der nächste auszuführende Schritt angezeigt.

on_fail_action

tinyint

Auszuführende Aktion, wenn der Schritt einen Fehler erzeugt. Die Werte entsprechen den Werten von on_success_action.

on_fail_step_id

int

Wenn on_fail_action den Wert 4 aufweist, wird hiermit der nächste auszuführende Schritt angezeigt.

server

sysname

Reserviert.

database_name

sysname

Für einen Transact-SQL-Schritt ist dies die Datenbank, in der der Befehl ausgeführt wird.

database_user_name

sysname

Für einen Transact-SQL-Schritt ist dies der Datenbank-Benutzerkontext, in dem der Befehl ausgeführt wird.

retry_attempts

int

Die maximale Anzahl von Wiederholungsversuchen für den Befehl (falls er nicht erfolgreich ist).

retry_interval

int

Das Intervall (in Minuten) zwischen den Wiederholungsversuchen.

os_run_priority

int

Reserviert.

output_file_name

nvarchar(200)

Datei, in die die Befehlsausgabe geschrieben werden soll (nur Transact-SQL-, CmdExec- und PowerShell-Schritte).

last_run_outcome

int

Ergebnis der letzten Ausführung des Schritts:

0 = Fehler

1 = Erfolg

2 = Wiederholen

3 = Abgebrochen

5 = Unbekannt

last_run_duration

int

Die Ausführungsdauer (in Sekunden) des Schritts bei der letzten Ausführung.

last_run_retries

int

Anzahl der Wiederholungsversuche für den Befehl bei der letzten Ausführung des Schritts

last_run_date

int

Datum, an dem die Ausführung des Schritts zuletzt gestartet wurde

last_run_time

int

Uhrzeit, zu der die Ausführung des Schritts zuletzt gestartet wurde.

proxy_id

int

Proxy für den Auftragsschritt.

Hinweise

sp_help_jobstep befindet sich in der msdb-Datenbank.

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 können nur die Auftragsschritte für Aufträge anzeigen, deren Besitzer sie sind.

Beispiele

A.Zurückgeben von Informationen für alle Schritte in einem bestimmten Auftrag

Im folgenden Beispiel werden alle Auftragsschritte für den Auftrag Weekly Sales Data Backup zurückgegeben.

USE msdb ;
GO

EXEC dbo.sp_help_jobstep
    @job_name = N'Weekly Sales Data Backup' ;
GO

B.Zurückgeben von Informationen zu einem bestimmten Auftragsschritt

Im folgenden Beispiel werden Informationen zum ersten Auftragsschritt des Auftrags Weekly Sales Data Backup zurückgegeben.

USE msdb ;
GO

EXEC dbo.sp_help_jobstep
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1 ;
GO

Siehe auch

Verweis

sp_add_jobstep (Transact-SQL)

sp_delete_jobstep (Transact-SQL)

sp_help_job (Transact-SQL)

sp_update_jobstep (Transact-SQL)

Gespeicherte Systemprozeduren (Transact-SQL)