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 = ] '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)
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für