sp_help_jobsteplog (Transact-SQL)
Gibt Metadaten zu einem bestimmten Auftragsschrittprotokoll des SQL Server-Agents zurück. sp_help_jobsteplog gibt nicht das eigentliche Protokoll zurück.
Syntax
sp_help_jobsteplog { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }
[ , [ @step_id = ] step_id ]
[ , [ @step_name = ] 'step_name' ]
Argumente
- [ @job_id =] 'job_id'
Die ID des Auftrags, zu dem Auftragsschritt-Protokollinformationen zurückgegeben werden sollen. job_id ist ein Wert vom Datentyp int; der Standardwert ist NULL.
[ @job_name =] 'job_name'
Der Name des Auftrags. job_name ist ein Wert vom Datentyp sysname. Der Standardwert ist NULL..gif "ms175077.note(de-de,SQL.90).gif")
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 Auftragsschrittes. Wenn diese ID nicht eingeschlossen ist, werden alle Schritte des Auftrags eingeschlossen. step_id ist ein Wert vom Datentyp int; der Standardwert ist NULL.
- [ @step_name =] 'step_name'
Der Name des Auftragsschrittes. step_name ist ein Wert vom Datentyp sysname; der Standardwert ist NULL.
Rückgabecodewerte
0 (Erfolg) oder 1 (Fehler)
Resultsets
| Spaltenname | Datentyp | Beschreibung |
|---|---|---|
job_id |
uniqueidentifier |
Eindeutiger Bezeichner des Auftrags. |
job_name |
sysname |
Name des Auftrags. |
step_id |
int |
Bezeichner des Schrittes innerhalb des Auftrags. Wenn es sich beispielsweise um den ersten Schritt im Auftrag handelt, ist step_id gleich 1. |
step_name |
sysname |
Name des Auftragsschrittes. |
step_uid |
uniqueidentifier |
Eindeutiger Bezeichner des Schrittes (systemgeneriert) im Auftrag. |
date_created |
datetime |
Datum, an dem der Schritt erstellt wurde. |
date_modified |
datetime |
Datum, an dem der Schritt zuletzt geändert wurde. |
log_size |
float |
Größe des Auftragsschrittprotokolls in MB. |
log |
nvarchar(max) |
Ausgabe des Auftragsschrittprotokolls. |
Hinweise
sp_help_jobsteplog ist in der msdb-Datenbank gespeichert.
Berechtigungen
Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Andere Benutzer müssen Mitglieder der festen SQL Server-Agent-Datenbankrollen in der msdb-Datenbank sein:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.
Mitglieder der SQLAgentUserRole-Datenbankrolle können nur Metadaten des Auftragsschrittprotokolls für Auftragsschritte anzeigen, die sie besitzen.
Beispiele
A. Zurückgeben von Auftragsschrittinformationen für alle Schritte eines bestimmten Auftrags
Im folgenden Beispiel werden alle Auftragsschrittinformationen für den Auftrag namens Weekly Sales Data Backup zurückgegeben.
USE msdb ;
GO
EXEC dbo.sp_help_jobsteplog
@job_name = N'Weekly Sales Data Backup' ;
GO
B. Zurückgeben von Auftragsschrittinformationen zu einem bestimmten Auftragsschritt
Im folgenden Beispiel werden Auftragsschrittinformationen zum ersten Auftragsschritt des Auftrags namens Weekly Sales Data Backup zurückgegeben.
USE msdb ;
GO
EXEC dbo.sp_help_jobsteplog
@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_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_delete_jobsteplog (Transact-SQL)
Gespeicherte Prozeduren des SQL Server-Agents (Transact-SQL)