sp_help_jobsteplog (Transact-SQL)

Artikel
2025-01-02

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 `1`es `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

Sie können Berechtigungen für dieses Verfahren erteilen EXECUTE , aber diese Berechtigungen können 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

Freigeben über