sp_help_jobserver (Transact-SQL)

  • Artikel

Gilt für: SQL Server

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

Transact-SQL-Syntaxkonventionen

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

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 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

Zugehöriger Inhalt