sp_help_jobserver (Transact-SQL)

Artikel
05/23/2023

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

Syntax

  
sp_help_jobserver  
     { [ @job_id = ] job_id   
     | [ @job_name = ] 'job_name' }  
     [ , [ @show_last_run_details = ] show_last_run_details ]

Argumente

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

[ @job_name = ] 'job_name' Der Auftragsname, für den Informationen zurückgegeben werden sollen. job_name ist sysname mit dem Standardwert NULL.

Hinweis

Es muss entweder job_id oder job_name angegeben werden, aber beide können nicht angegeben werden.

[ @show_last_run_details = ] show_last_run_details Gibt an, ob die Ausführungsinformationen der letzten Ausführung Teil des Resultsets sind. show_last_run_details ist tinyint mit dem Standardwert 0. 0 enthält keine Informationen zur letzten Ausführung, und 1 bereits.

Rückgabecodewerte

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

Resultsets

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 sp_help_jobserver mit show_last_run_details ausgeführt wird, die auf 1 festgelegt ist, enthält das Resultset diese zusätzlichen Spalten.

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 = Fehler 1 = Erfolgreich 3 = Abgebrochen 5 = Unbekannt

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

Weitere Informationen

sp_add_jobserver (Transact-SQL)
sp_delete_jobserver (Transact-SQL)
Gespeicherte Systemprozeduren (Transact-SQL)