• Artikel

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.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

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.

    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 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 Auftragsschritts. 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 Schritts innerhalb des Auftrags. Wenn es sich beispielsweise um den ersten Schritt im Auftrag handelt, ist step_id gleich 1.

step_name

sysname

Name des Auftragsschritts.

step_uid

uniqueidentifier

Eindeutiger Bezeichner des Schritts (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