Freigeben über


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 vom Datentyp int. 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.

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. 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 der SQLAgentUserRole-Datenbankrolle können nur Metadaten des Auftragsschrittprotokolls für Auftragsschritte anzeigen, die sie besitzen.

Beispiele

A.Gibt Auftragsschritt-Protokollinformationen für alle Schritte in einem bestimmten Auftrag zurück

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 Auftragsschritt-Protokollinformationen 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)