sp_help_jobserver (Transact-SQL)

Artikel
2025-01-02

Gilt für: SQL Server

Gibt Informationen zum Server für einen bestimmten Auftrag zurück.

Syntax

sp_help_jobserver
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @show_last_run_details = ] show_last_run_details ]
[ ; ]

Argumente

[ @job_id = ] 'job_id'

Die ID des Auftrags, zu dem Informationen 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, für den Informationen zurückgegeben werden sollen. @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.

[ @show_last_run_details = ] show_last_run_details

Gibt an, ob die Informationen zur letzten Ausführung Teil des Resultsets sind. @show_last_run_details ist winzig, mit einem Standardwert von 0.

0 enthält keine Informationen zur letzten Ausführung.
1 enthält Informationen zur letzten Ausführung.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

Spaltenname	Datentyp	BESCHREIBUNG
`server_id`	int	ID des Zielservers
`server_name`	nvarchar(30)	Computername des Zielservers
`enlist_date`	datetime	Datum, an dem der Zielserver auf dem Masterserver eingetragen wurde
`last_poll_date`	datetime	Datum, an dem der Zielserver den Masterserver zuletzt abgerufen hat

Wenn sie mit @show_last_run_details festgelegt wird, weist das Resultset diese zusätzlichen Spalten auf.If sp_help_jobserver is executed with @show_last_run_details set to 1, the result set has these extra columns.

Spaltenname	Datentyp	BESCHREIBUNG
`last_run_date`	int	Datum, an dem die Ausführung des Auftrags auf diesem Zielserver zuletzt gestartet wurde
`last_run_time`	int	Uhrzeit, zu der die Ausführung des Auftrags auf diesem Server zuletzt gestartet wurde
`last_run_duration`	int	Dauer des Auftrags bei der letzten Ausführung auf diesem Zielserver (in Sekunden)
`last_outcome_message`	nvarchar(1024)	Beschreibt das letzte Ergebnis des Auftrags
`last_run_outcome`	int	Ergebnis des Auftrags bei der letzten Ausführung auf diesem Server: `0` = Fehlgeschlagen `1` = Erfolgreich `3` = Abgebrochen `5` = Unbekannt

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 Informationen für Aufträge anzeigen, die sie besitzen.

Beispiele

Im folgenden Beispiel werden Informationen, einschließlich der Informationen zur letzten Ausführung, zum NightlyBackups-Auftrag zurückgegeben.

USE msdb;
GO

EXEC dbo.sp_help_jobserver
    @job_name = N'NightlyBackups',
    @show_last_run_details = 1;
GO

Freigeben über