sp_who (Transact-SQL)

Gilt für: SQL Server

Stellt Informationen zu aktuellen Benutzern, Sitzungen und Prozessen in einer Instanz des SQL Server-Datenbank-Engine bereit. Die Informationen können gefiltert werden, um nur die Prozesse zurückzugeben, die nicht im Leerlauf sind, zu einem bestimmten Benutzer gehören oder zu einer bestimmten Sitzung gehören.

Transact-SQL-Syntaxkonventionen

Syntax

sp_who [ [ @loginame = ] { 'login' | *session_id* | 'ACTIVE' } ]
[ ; ]

Argumente

[ @loginame = ] { 'login' | session_id | 'ACTIVE' }

Wird zum Filtern des Resultsets verwendet.

  • login ist sysname , der Prozesse identifiziert, die zu einer bestimmten Anmeldung gehören.

  • session_id ist eine Sitzungsidentifikationsnummer, die zur SQL Server-Instanz gehört. session_id ist klein.

  • ACTIVE schließt Sitzungen aus, die auf den nächsten Befehl des Benutzers warten.

Wenn kein Wert angegeben ist, meldet die Prozedur alle zur Instanz gehörenden Sitzungen.

Rückgabecodewerte

0 (erfolgreich) oder 1 Fehler.

Resultset

sp_who gibt ein Resultset mit den folgenden Informationen zurück.

Spalte Datentyp Beschreibung
spid smallint Sitzungs-ID.
ecid smallint Ausführungskontext-ID für einen bestimmten Thread, der einer bestimmten Sitzungs-ID zugeordnet ist.

ECID = { 0, 1, 2, 3, ...n }, wobei 0 immer den Hauptthread oder den übergeordneten Thread darstellt, und { 1, 2, 3, ...n } stellt die Unterthreads dar.
status nchar(30) Prozessstatus. Mögliche Werte sind:

- dormant. SQL Server setzt die Sitzung zurück.

- running. Die Sitzung führt einen oder mehrere Batches aus. Wenn MARS (Multiple Active Result Sets) aktiviert ist, kann eine Sitzung mehrere Batches ausführen. Weitere Informationen finden Sie unter Verwenden von Multiple Active Result Sets (MARS).

- background. Die Sitzung führt einen Hintergrundtask aus, z. B. Deadlockerkennung.

- rollback. Die Sitzung führt gerade einen Transaktionsrollback aus.

- pending. Die Sitzung wartet, dass ein Arbeitsthread verfügbar wird.

- runnable. Der Task der Sitzung wartet in der ausführbaren Warteschlange eines Zeitplanungsmoduls darauf, ein Zeitquantum zu erhalten.

- spinloop. Der Task der Sitzung wartet darauf, dass ein Spinlock frei wird.

- suspended. Die Sitzung wartet, dass ein Ereignis, z. B. E/A, abgeschlossen wird.
loginame nchar(128) Dem entsprechenden Prozess zugeordneter Benutzername.
hostname nchar(128) Host- oder Computername für den Prozess.
blk char(5) Sitzungs-ID für den blockierenden Prozess, falls vorhanden. Andernfalls ist 0diese Spalte .

Wenn eine Transaktion, die einer angegebenen Sitzungs-ID zugeordnet ist, durch eine verwaiste verteilte Transaktion blockiert wird, gibt diese Spalte eine -2 für die blockierte verwaiste Transaktion zurück.
dbname nchar(128) Vom Prozess verwendete Datenbank.
cmd nchar(16) Datenbank-Engine Befehl (Transact-SQL-Anweisung, interner Datenbank-Engine-Prozess usw.), der für den Prozess ausgeführt wird. In SQL Server 2019 (15.x) und höheren Versionen ist der Datentyp nchar(26).
request_id int ID für Anforderungen, die in einer bestimmten Sitzung ausgeführt werden.

Bei paralleler Verarbeitung werden Unterthreads für die spezifische Sitzungs-ID erstellt. Der Hauptthread wird mit spid = <xxx> und ecid = 0 angegeben. Die anderen Unterthreads haben dasselbe spid = <xxx>, aber mit ecid > 0.

Hinweise

Ein Blockierungsprozess, der möglicherweise über eine exklusive Sperre verfügt, ist eine, die Ressourcen enthält, die ein anderer Prozess benötigt.

Allen verwaisten verteilten Transaktionen wird der Sitzungs-ID-Wert zugewiesen.-2 Verwaiste verteilte Transaktionen sind verteilte Transaktionen, die keiner Sitzungs-ID zugeordnet sind. Weitere Informationen finden Sie unter Verwendung von markierten Transaktionen zum konsistenten Wiederherstellen verwandter Datenbanken.

Fragen Sie die is_user_process Spalte ab, sys.dm_exec_sessions um Systemprozesse von Benutzerprozessen zu trennen.

Berechtigungen

Erfordert view SERVER STATE-Berechtigung auf dem Server, um alle ausgeführten Sitzungen in der Instanz von SQL Server anzuzeigen. Andernfalls wird dem Benutzer nur die aktuelle Sitzung angezeigt.

Beispiele

A. Alle aktuellen Prozesse auflisten

Im folgenden Beispiel wird sp_who ohne Parameter verwendet, um alle aktuellen Benutzer zurückzugeben.

USE master;
GO
EXEC sp_who;
GO

B. Auflisten des Prozesses eines bestimmten Benutzers

Das folgende Beispiel veranschaulicht das Anzeigen von Informationen zu einem einzelnen aktuellen Benutzer anhand des Benutzernamens.

USE master;
GO
EXEC sp_who 'janetl';
GO

C. Alle aktiven Prozesse anzeigen

USE master;
GO
EXEC sp_who 'active';
GO

D: Anzeigen eines bestimmten Prozesses, der durch eine Sitzungs-ID identifiziert wird

USE master;
GO
EXEC sp_who '10' --specifies the process_id;
GO