Teilen über


sp_help_jobsteplog (Transact-SQL)

Gilt für: SQL Server

Gibt Metadaten zu einem bestimmten SQL Server-Agent Auftragsschrittprotokoll zurück. sp_help_jobsteplog gibt das tatsächliche Protokoll nicht zurück.

Transact-SQL-Syntaxkonventionen

Syntax

sp_help_jobsteplog
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'step_name' ]
[ ; ]

Argumente

[ @job_id = ] 'job_id'

Die ID des Auftrags, zu dem Auftragsschritt-Protokollinformationen zurückgegeben werden sollen. @job_id ist eindeutiger Bezeichner mit einem Standardwert von NULL.

Entweder @job_id oder @job_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

[ @job_name = ] N'job_name'

Der Name des Auftrags. @job_name ist "sysname" mit der Standardeinstellung "NULL.

Entweder @job_id oder @job_name müssen angegeben werden, beide können jedoch nicht angegeben werden.

[ @step_id = ] step_id

Die ID des Auftragsschritts. Wenn diese nicht angegeben wird, sind alle Schritte im Auftrag eingeschlossen. @step_id ist int mit einem Standardwert von NULL.

[ @step_name = ] N'step_name'

Der Name des Schritts im Auftrag. @step_name ist "sysname" mit der Standardeinstellung "NULL.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Spaltenname Datentyp Beschreibung
job_id uniqueidentifier Eindeutiger Bezeichner des Auftrags.
job_name sysname Der Name des Auftrags.
step_id int Bezeichner des Schritts innerhalb des Auftrags. Wenn der Schritt z. B. der erste Schritt im Auftrag ist, ist 1es step_id .
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 Megabyte (MB).
log nvarchar(max) Ausgabe des Auftragsschrittprotokolls.

Hinweise

sp_help_jobsteplog befindet sich in der msdb Datenbank.

Berechtigungen

Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE , diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.

Anderen Benutzern muss eine der folgenden SQL Server-Agent festen Datenbankrollen in der msdb Datenbank gewährt 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 Auftragsschrittprotokollmetadaten für auftragseigene Schritte anzeigen.

Beispiele

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

Im folgenden Beispiel werden alle Auftragsschrittprotokollinformationen für den Auftrag mit dem Namen zurückgegeben Weekly Sales Data Backup.

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 Auftragsschrittprotokollinformationen zum ersten Auftragsschritt für den Auftrag mit dem Namen zurückgegeben Weekly Sales Data Backup.

USE msdb;
GO

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