sp_help_jobstep (Transact-SQL)

Artikel
06/18/2013

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.

Hinweis

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.

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

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)

Freigeben über