sp_who (Transact-SQL)

  • 项目

适用于：SQL Server

提供有关 SQL Server 数据库引擎实例中的当前用户、会话和进程的信息。 可以筛选信息，以仅返回那些未空闲、属于特定用户或属于特定会话的进程。

Transact-SQL 语法约定

语法

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

参数

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

用于筛选结果集。

  • login 是 标识属于特定登录名的进程的 sysname 。

  • session_id 是属于 SQL Server 实例的会话标识号。 session_id较小。

  • ACTIVE 排除正在等待用户下一个命令的会话。

如果没有提供任何值，则过程报告属于实例的所有会话。

返回代码值

0（成功）或 1（失败）。

结果集

sp_who 返回一个结果集，其中包含以下信息。

列 数据类型 描述
spid smallint 会话 ID。
ecid smallint 与特定会话 ID 相关联的给定线程的执行上下文 ID。

ECID = { 0， 1， 2， 3， ...n }，其中 0 始终表示主线程或父线程，{ 1、2、3...n } 表示子线程。
status nchar(30) 进程状态。 可能的值为：

- dormant。 SQL Server 正在重置会话。

- running。 会话正在运行一个或多个批。 多个活动的结果集 (MARS) 启用后，会话可以运行多个批。 有关详细信息，请参阅使用多重活动结果集 (MARS)。

- background。 会话正在运行一个后台任务，例如死锁检测。

- rollback。 会话具有正在处理的事务回滚。

- pending。 会话正在等待工作线程变为可用。

- runnable。 会话的任务在等待获取时间量程时位于计划程序的可运行队列中。

- spinloop。 会话的任务正在等待调节锁变为可用。

- suspended。 会话正在等待事件（如 I/O）完成。
loginame nchar(128) 与特定进程相关联的登录名。
hostname nchar(128) 每个进程的主机或计算机名。
blk char（5） 如果存在阻塞进程，则是该阻塞进程的会话 ID。 否则，此列为 0.

当与指定会话 ID 关联的事务被孤立的分布式事务阻止时，此列将返回阻塞孤立事务的一个 -2 。
dbname nchar(128) 进程使用的数据库。
cmd nchar(16) 数据库引擎命令（Transact-SQL 语句、内部数据库引擎进程等）为进程执行。 在 SQL Server 2019（15.x）及更高版本中，数据类型为 nchar（26）。
request_id int 特定会话中运行的请求的 ID。

通过并行处理，将为特定会话 ID 创建子线程。 主线程则以 spid = <xxx> 和 ecid = 0 表示。 其他子线程具有相同 spid = <xxx>的，但具有 ecid > 0。

注解

阻塞进程（可能含有排他锁）是控制其他进程所需要的资源的进程。

为所有孤立的分布式事务分配会话 ID 值 -2。 孤立分布式事务是未与任何会话 ID 关联的分布式事务。 有关详细信息，请参阅使用标记的事务一致地恢复相关的数据库（完整恢复模式）。

is_user_process查询将系统进程与用户进程分开的列sys.dm_exec_sessions。

权限

要求服务器上的 VIEW 标准版RVER STATE 权限才能在 SQL Server 实例上查看所有正在执行的会话。 否则，用户只能查看当前会话。

示例

A. 列出所有当前进程

以下示例使用没有参数的 sp_who 来报告所有当前用户。

USE master;
GO
EXEC sp_who;
GO

B. 列出特定用户的进程

以下示例显示如何通过登录名查看有关单个当前用户的信息。

USE master;
GO
EXEC sp_who 'janetl';
GO

°C 显示所有活动进程

USE master;
GO
EXEC sp_who 'active';
GO

D. 显示会话 ID 标识的特定进程

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

相关内容