Artikel
03/30/2012

sp_help_jobserver (Transact-SQL)

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

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

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 ID des Auftrags, für den Informationen zurückgegeben werden sollen. job_id ist vom Datentyp uniqueidentifier; der Standardwert ist NULL.
[ @job_name= ] 'job_name'
Der Name des Auftrags, für den Informationen zurückgegeben werden sollen. job_name ist vom Datentyp sysname; der Standardwert ist NULL.

Hinweis

Es muss entweder job_id oder job_name angegeben werden, aber beide Angaben sind nicht möglich.
[ @show_last_run_details= ] show_last_run_details
Gibt an, ob die Informationen zur letzten Ausführung in das Resultset einbezogen werden. show_last_run_details ist vom Datentyp tinyint; der Standardwert ist 0. 0 gibt an, dass die Informationen zur letzten Ausführung nicht eingeschlossen werden. Bei 1 sind sie Teil des Resultsets.

Hinweis
Es muss entweder job_id oder job_name angegeben werden, aber beide Angaben sind nicht möglich.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

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 ausgeführt wird und show_last_run_details auf 1 festgelegt ist, weist das Resultset die folgenden zusätzlichen Spalten auf.

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 = Erfolg 3 = Abgebrochen 5 = Unbekannt

Berechtigungen

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen. Anderen Benutzern muss eine der folgenden festen Datenbankrollen des SQL Server-Agents in der msdb-Datenbank zugewiesen 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 Informationen zu ihren eigenen Aufträgen anzeigen.

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

Siehe auch

Verweis

sp_add_jobserver (Transact-SQL)

sp_delete_jobserver (Transact-SQL)

Gespeicherte Systemprozeduren (Transact-SQL)

Freigeben über