sp_help_jobhistory (Transact-SQL)

Artikel
05/22/2024

Gilt für: SQL Server

Stellt Informationen zu den Aufträgen für Server in der Domäne zur Multiserveradministration bereit.

Syntax

sp_help_jobhistory
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @sql_message_id = ] sql_message_id ]
    [ , [ @sql_severity = ] sql_severity ]
    [ , [ @start_run_date = ] start_run_date ]
    [ , [ @end_run_date = ] end_run_date ]
    [ , [ @start_run_time = ] start_run_time ]
    [ , [ @end_run_time = ] end_run_time ]
    [ , [ @minimum_run_duration = ] minimum_run_duration ]
    [ , [ @run_status = ] run_status ]
    [ , [ @minimum_retries = ] minimum_retries ]
    [ , [ @oldest_first = ] oldest_first ]
    [ , [ @server = ] N'server' ]
    [ , [ @mode = ] 'mode' ]
[ ; ]

Argumente

[ @job_id = ] 'job_id'

Die Auftrags-ID @job_id ist eindeutiger Bezeichner mit einem Standardwert von NULL.

[ @job_name = ] N'job_name'

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

[ @step_id = ] step_id

Die Schritt-ID. @step_id ist int mit einem Standardwert von NULL.

[ @sql_message_id = ] sql_message_id

Die Identifikationsnummer der Fehlermeldung, die von SQL Server beim Ausführen des Auftrags zurückgegeben wird. @sql_message_id ist int, mit einem Standardwert von NULL.

[ @sql_severity = ] sql_severity

Der Schweregrad der Fehlermeldung, die von SQL Server beim Ausführen des Auftrags zurückgegeben wurde. @sql_severity ist int, mit einem Standardwert von NULL.

[ @start_run_date = ] start_run_date

Das Datum, an dem der Auftrag gestartet wurde. @start_run_date ist int mit einem Standardwert von NULL. @start_run_date muss in das Formular yyyyMMddeingegeben werden, wobei yyyy es sich um ein vierstelliges Jahr handelt, MM einen zweistelligen Monatsnamen und dd einen zweistelligen Tagnamen ist.

[ @end_run_date = ] end_run_date

Das Datum, an dem der Auftrag abgeschlossen wurde. @end_run_date ist int mit einem Standardwert von NULL. @end_run_date muss in das Formular yyyyMMddeingegeben werden, wobei yyyy es sich um ein vierstelliges Jahr handelt, MM einen zweistelligen Monatsnamen und dd einen zweistelligen Tagnamen ist.

[ @start_run_time = ] start_run_time

Die Uhrzeit, zu der der Auftrag gestartet wurde. @start_run_time ist int mit einem Standardwert von NULL. @start_run_time muss in das Formular HHmmsseingegeben werden, wobei HH es sich um eine zweistellige Stunde des Tages handelt, mm eine zweistellige Minute des Tages und ss ein zweistellige Sekunde des Tages ist.

[ @end_run_time = ] end_run_time

Die Uhrzeit, zu der die Ausführung des Auftrags abgeschlossen wurde. @end_run_time ist int mit einem Standardwert von NULL. @end_run_time muss in das Formular HHmmsseingegeben werden, wobei HH es sich um eine zweistellige Stunde des Tages handelt, mm eine zweistellige Minute des Tages und ss ein zweistellige Sekunde des Tages ist.

[ @minimum_run_duration = ] minimum_run_duration

Die minimale Zeit für den Abschluss des Auftrags. @minimum_run_duration ist int mit einem Standardwert von NULL. @minimum_run_duration muss in das Formular HHmmsseingegeben werden, wobei HH es sich um eine zweistellige Stunde des Tages handelt, mm eine zweistellige Minute des Tages und ss ein zweistellige Sekunde des Tages ist.

[ @run_status = ] run_status

Der Ausführungsstatus des Auftrags.@run_status ist int und kann einer dieser Werte sein.

Wert	Beschreibung
`0`	Fehler
`1`	Erfolgreich
`2`	Wiederholen (nur Schritte)
`3`	Storniert
`4`	In Bearbeitungsmeldung
`5`	Unbekannt

[ @minimum_retries = ] minimum_retries

Die Mindestanzahl von Wiederholungsversuchen für die Ausführung eines Auftrags. @minimum_retries ist int mit einem Standardwert von NULL.

[ @oldest_first = ] oldest_first

Gibt an, ob die Ausgabe zuerst mit den ältesten Aufträgen dargestellt werden soll. @oldest_first ist int mit einem Standardwert von 0.

0 stellt zuerst die neuesten Aufträge vor.
1 stellt zuerst die ältesten Aufträge dar.

[ @server = ] N'server'

Der Name des Servers, auf dem der Auftrag ausgeführt wurde. @server ist "sysname" mit dem Standardwert "NULL.

[ @mode = ] 'Mode'

Gibt an, ob SQL Server alle Spalten im Resultset (FULL) oder eine Zusammenfassung (SUMMARY) der Spalten druckt. @mode ist varchar(7) mit einem Standardwert von SUMMARY.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Die tatsächliche Spaltenliste hängt vom Wert @mode ab. Der umfassendste Satz von Spalten wird in der folgenden Tabelle angezeigt und wird zurückgegeben, wenn @mode ist FULL.

Spaltenname	Datentyp	BESCHREIBUNG
`instance_id`	int	Verlaufseintrags-ID
`job_id`	uniqueidentifier	Auftragsidentifikationsnummer.
`job_name`	sysname	Auftragsname.
`step_id`	int	Schrittidentifikationsnummer (`0` für einen Auftragsverlauf).
`step_name`	sysname	Schrittname (`NULL` für einen Jobverlauf).
`sql_message_id`	int	Bei einem Transact-SQL-Schritt ist die letzte Transact-SQL-Fehlernummer beim Ausführen des Befehls aufgetreten.
`sql_severity`	int	Bei einem Transact-SQL-Schritt ist der höchste Transact-SQL-Fehlerschweregrad beim Ausführen des Befehls aufgetreten.
`message`	nvarchar(1024)	Meldung zu Auftrags- oder Schrittverlauf.
`run_status`	int	Ergebnis des Auftrags oder Schritts.
`run_date`	int	Datum, an dem das Ausführen des Auftrags oder Schritts begann.
`run_time`	int	Uhrzeit, zu der das Ausführen des Auftrags oder Schritts begann.
`run_duration`	int	Verstrichene Zeit bei der Ausführung des Auftrags oder Schritts im `HHmmss` Format.
`operator_emailed`	nvarchar(20)	Betreiber, der in Bezug auf diesen Auftrag per E-Mail gemailt wurde (gilt `NULL` für den Schrittverlauf).
`operator_netsent`	nvarchar(20)	Der Betreiber, der eine Netzwerknachricht zu diesem Auftrag gesendet hat (gilt `NULL` für den Schrittverlauf).
`operator_paged`	nvarchar(20)	Operator, der in Bezug auf diesen Auftrag ausgelagert wurde (ist `NULL` für den Schrittverlauf).
`retries_attempted`	int	Die Wiederholungsversuche für den Schritt (für einen Auftragsverlauf immer 0).
`server`	nvarchar(30)	Server, auf dem der Schritt oder Auftrag ausgeführt wird. Ist immer (`local`).

Hinweise

sp_help_jobhistory gibt einen Bericht mit dem Verlauf der angegebenen geplanten Aufträge zurück. Werden keine Parameter angegeben, enthält der Bericht den Verlauf aller geplanten Aufträge.

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 der SQLAgentUserRole-Datenbankrolle können nur den Verlauf für Aufträge anzeigen, die sie besitzen.

Beispiele

A. Auflisten aller Auftragsinformationen für einen Auftrag

Im folgenden Beispiel werden alle Auftragsinformationen für den NightlyBackups-Auftrag aufgelistet.

USE msdb;
GO

EXEC dbo.sp_help_jobhistory
    @job_name = N'NightlyBackups';
GO

B. Auflisten von Informationen für Aufträge, die bestimmten Bedingungen entsprechen

Im folgenden Beispiel werden alle Spalten und alle Auftragsinformationen für alle fehlgeschlagenen Aufträge und fehlgeschlagenen Auftragsschritte mit der Fehlermeldung 50100 (eine benutzerdefinierte Fehlermeldung) und einem Schweregrad von 20 aufgelistet.

USE msdb;
GO

EXEC dbo.sp_help_jobhistory
    @sql_message_id = 50100,
    @sql_severity = 20,
    @run_status = 0,
    @mode = N'FULL';
GO

Teilen über

sp_help_jobhistory (Transact-SQL)

Syntax

Argumente

[ @job_id = ] 'job_id'

[ @job_name = ] N'job_name'

[ @step_id = ] step_id

[ @sql_message_id = ] sql_message_id

[ @sql_severity = ] sql_severity

[ @start_run_date = ] start_run_date

[ @end_run_date = ] end_run_date

[ @start_run_time = ] start_run_time

[ @end_run_time = ] end_run_time

[ @minimum_run_duration = ] minimum_run_duration

[ @run_status = ] run_status

[ @minimum_retries = ] minimum_retries

[ @oldest_first = ] oldest_first

[ @server = ] N'server'

[ @mode = ] 'Mode'

Rückgabecodewerte

Resultset

Hinweise

Berechtigungen

Beispiele

A. Auflisten aller Auftragsinformationen für einen Auftrag

B. Auflisten von Informationen für Aufträge, die bestimmten Bedingungen entsprechen

Feedback

Zusätzliche Ressourcen

Teilen über

sp_help_jobhistory (Transact-SQL)

Syntax

Argumente

[ @job_id = ] 'job_id'

[ @job_name = ] N'job_name'

[ @step_id = ] step_id

[ @sql_message_id = ] sql_message_id

[ @sql_severity = ] sql_severity

[ @start_run_date = ] start_run_date

[ @end_run_date = ] end_run_date

[ @start_run_time = ] start_run_time

[ @end_run_time = ] end_run_time

[ @minimum_run_duration = ] minimum_run_duration

[ @run_status = ] run_status

[ @minimum_retries = ] minimum_retries

[ @oldest_first = ] oldest_first

[ @server = ] N'server'

[ @mode = ] 'Mode'

Rückgabecodewerte

Resultset

Hinweise

Berechtigungen

Beispiele

A. Auflisten aller Auftragsinformationen für einen Auftrag

B. Auflisten von Informationen für Aufträge, die bestimmten Bedingungen entsprechen

Zugehöriger Inhalt

Feedback

Zusätzliche Ressourcen