sp_help_jobactivity (Transact-SQL)

Artikel
11/07/2023

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

Syntax

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

Argumente

[ @job_id = ] job_id Die Auftragsidentifikationsnummer. job_idist uniqueidentifier mit dem Standardwert NULL.

[ @job_name = ] 'job_name' Der Name des Auftrags. job_nameist sysname mit dem Standardwert NULL.

Hinweis

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

[ @session_id = ] session_id Die Sitzungs-ID, über die Informationen gemeldet werden sollen. session_id ist int mit dem Standardwert 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	Der 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. Enthält einen der folgenden Werte: 1 = Ausführen nach einem Zeitplan 2 = Ausführen als Reaktion auf eine Warnung 3 = Beim Start ausführen 4 = Vom Benutzer ausgeführt 6 = Ausführung im CPU-Leerlaufzeitplan
queued_date	datetime	Datum, an dem die Anforderung in die Warteschlange aufgenommen wurde. NULL, wenn 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.
Nachricht	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 = Erfolgreich 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-Nummer des Operators, der bei Abschluss des Auftrags per net send benachrichtigt wird.
operator_id_paged	int	ID des Operators, der durch einen Pager bei Beendigung des Auftrags benachrichtigt wurde.

Bemerkungen

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

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

Wenn keine session_id bereitgestellt wird, werden Informationen zur letzten Sitzung aufgelistet.

Wenn keine job_name oder job_id bereitgestellt wird, werden Informationen für alle Aufträge aufgelistet.

Berechtigungen

Standardmäßig können 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.

Nur Mitglieder von sysadmin können die Aktivität für Aufträge anzeigen, die sich im Besitz anderer Benutzer befinden.

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

Weitere Informationen

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