sp_help_jobactivity (Transact-SQL)

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

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 Auftrags-ID job_idist vom Datentyp uniqueidentifier. Der Standardwert ist NULL.

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

• [ @session_id = ] session_id
  Die Sitzungs-ID, zu der Informationen erstellt werden sollen. session_id ist 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 des Auftrags 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

Siehe auch

Verweis

Gespeicherte Prozeduren des SQL Server-Agents (Transact-SQL)