sp_help_jobsteplog (Transact-SQL)

Artikel
11/07/2023

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 = ] 'job_name' }  
     [ , [ @step_id = ] step_id ]  
     [ , [ @step_name = ] 'step_name' ]

Argumente

[ @job_id = ] 'job_id' Die Auftragsidentifikationsnummer, für die Auftragsschrittprotokollinformationen zurückgegeben werden sollen. job_id ist int mit dem Standardwert NULL.

[ @job_name = ] 'job_name' Der Name des Auftrags. job_name ist sysname mit dem Standardwert NULL.

Hinweis

Es müssen entweder job_id oder job_name angegeben werden, aber beide können nicht angegeben werden.

[ @step_id = ] step_id Die Identifikationsnummer des Schritts im Auftrag. Wenn diese nicht angegeben wird, sind alle Schritte im Auftrag eingeschlossen. step_id ist int mit dem Standardwert NULL.

[ @step_name = ] 'step_name' Der Name des Schritts im Auftrag. step_name ist sysname mit dem Standardwert NULL.

Rückgabecodewerte

„0“ (erfolgreich) oder „1“ (fehlerhaft)

Resultsets

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 beispielsweise der erste Schritt im Auftrag ist, ist sein step_id 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.

Bemerkungen

sp_help_jobsteplog befindet sich in der msdb-Datenbank .

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 von SQLAgentUserRole können nur Auftragsschrittprotokollmetadaten für Auftragsschrittschritte 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

Weitere Informationen

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)