• Artikel

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.

    HinweisHinweis

    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.

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