Share via

  • Artikel

sp_help_jobactivity (Transact-SQL)

Listet Informationen zum Laufzeitstatus von SQL Server-Agent-Aufträgen auf.

Themenlink (Symbol)Transact-SQL-Syntaxkonventionen

Syntax

        sp_help_jobactivity { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
     [ , [ @session_id = ] session_id ]

Argumente

  • [ @job_id =] job_id
    Die ID des Auftrags. job_id ist vom Datentyp uniqueidentifier; der Standardwert ist NULL.

  • [ @job_name =] 'job_name'
    Der Name des Auftrags. 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.

  • [ @session_id = ] session_id
    Die Sitzungs-ID, zu der Informationen erstellt werden sollen. session_id ist ein Wert vom Datentyp int; der Standardwert ist NULL.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Resultsets

Gibt das folgende Resultset zurück:

Spaltenname

Datentyp

Beschreibung

session_id

int

Agent-Sitzungs-ID.

job_id

uniqueidentifier

ID für den Auftrag.

job_name

sysname

Name des Auftrags.

run_requested_date

datetime

Datum, zu dem die Ausführung des Auftrags angefordert wurde.

run_requested_source

sysname

Die Quelle der Anforderung zum Ausführen des Auftrags. Folgende Angaben sind möglich:

1 = Ausführen nach einem Zeitplan

2 = Ausführen als Reaktion auf eine Warnung

3 = Ausführen beim Start

4 = Ausführen durch einen Benutzer

6 = Ausführen nach einem Zeitplan für den CPU-Leerlauf

queued_date

datetime

Datum, an dem die Anforderung in die Warteschlange aufgenommen wurde. NULL, falls der Auftrag direkt ausgeführt wurde.

start_execution_date

datetime

Datum, an dem der Auftrag einem ausführbaren Thread zugewiesen wurde.

last_executed_step_id

int

Die Schritt-ID des zuletzt ausgeführten Auftragsschritts.

last_executed_step_date

datetime

Uhrzeit, zu der die Ausführung des zuletzt ausgeführten Auftragsschritts begonnen hat.

stop_execution_date

datetime

Uhrzeit, zu der die Ausführung des Auftrags beendet wurde.

next_scheduled_run_date

datetime

Datum, an dem die nächste Ausführung des Auftrags geplant ist.

job_history_id

int

ID für den Auftragsverlauf in der Auftragsverlaufstabelle.

message

nvarchar(1024)

Meldung, die während der letzten Ausführung des Auftrags ausgegeben wurde.

run_status

int

Status, der während der letzten Ausführung des Auftrags zurückgegeben wurde:

0 = Fehler

1 = Erfolg

3 = Abgebrochen

5 = Status unbekannt

operator_id_emailed

int

ID des Operators, der durch eine E-Mail-Nachricht bei Beendigung des Auftrags benachrichtigt wurde.

operator_id_netsent

int

ID des Operators, der durch eine net send-Nachricht bei Beendigung des Auftrags benachrichtigt wurde.

operator_id_paged

int

ID des Operators, der durch einen Pager bei Beendigung des Auftrags benachrichtigt wurde.

Hinweise

Diese Prozedur stellt eine Momentaufnahme des aktuellen Status der Aufträge bereit. Die zurückgegebenen Ergebnisse stellen Informationen zu dem Zeitpunkt der Anforderungsverarbeitung dar.

Vom SQL Server-Agent wird bei jedem Start des Agent-Diensts eine Sitzungs-ID erstellt. Die Sitzungs-ID wird in der msdb.dbo.syssessions-Tabelle gespeichert.

Wenn kein Wert für session_id bereitgestellt wird, werden Informationen zur letzten Sitzung aufgelistet.

Wenn kein Wert für job_name oder job_id bereitgestellt wird, werden Informationen für alle Aufträge aufgeführt.

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.

Nur Mitglieder der sysadmin-Serverrolle können die Aktivität für Aufträge anzeigen, deren Besitzer andere Benutzer sind.

Beispiele

Im folgenden Beispiel ist die Aktivität für alle Aufträge aufgeführt, zu deren Anzeige der Benutzer berechtigt ist.

USE msdb ;
GO

EXEC dbo.sp_help_jobactivity ;
GO