Apache Doris 数据库管理：SHOW PROCESSLIST 命令详解

概述

在数据库管理和性能调优过程中，了解当前正在执行的线程和查询状态至关重要。Apache Doris 提供了 SHOW PROCESSLIST 命令，允许数据库管理员和开发者查看当前数据库连接和正在执行的查询信息。本文将深入解析这一命令的使用方法、返回结果及其在实际运维中的应用场景。

命令语法

SHOW [FULL] PROCESSLIST

参数说明

FULL 参数

FULL 参数是一个可选修饰符，用于控制返回结果的详细程度：

• 不使用 FULL 参数时，命令仅显示当前用户的连接信息
• 使用 FULL 参数时，命令将显示所有用户的连接信息（需要管理员权限）

返回结果详解

SHOW PROCESSLIST 命令返回一个包含多列信息的表格，每列代表不同的连接或线程属性：

列名	说明
CurrentConnected	标识当前连接是否为执行该命令的连接
Id	线程的唯一标识符
User	发起该线程的用户名
Host	客户端IP地址和端口号
LoginTime	连接建立的时间
Catalog	当前命令执行所在的数据目录
Db	当前命令执行的数据库（未指定时为NULL）
Command	线程当前执行的命令类型
Time	命令从提交到当前状态的时间（秒）
State	线程状态
QueryId	当前查询语句的唯一ID
Info	线程执行的语句内容（默认只显示前100个字符）

常见命令类型

在 Command 列中，常见的线程状态包括：

• Query：线程正在执行SQL语句
• Sleep：线程等待客户端发送新的执行语句
• Quit：线程正在退出
• Kill：线程正在执行KILL命令

权限要求

执行 SHOW PROCESSLIST 命令需要以下权限：

• 基础权限：任何用户都可以查看自己的连接信息
• 查看其他用户连接：需要拥有 ADMIN_PRIV 权限

实际应用示例

基本用法

SHOW PROCESSLIST

典型返回结果：

+------------------+------+------+-----------------+---------------------+----------+------+---------+------+-------+-----------------------------------+-----------------------+
| CurrentConnected | Id   | User | Host            | LoginTime           | Catalog  | Db   | Command | Time | State | QueryId                           | Info                  |
+------------------+------+------+-----------------+---------------------+----------+------+---------+------+-------+-----------------------------------+-----------------------+
| Yes              |    0 | root | 127.0.0.1:34650 | 2025-01-21 12:01:02 | internal | test | Query   |    0 | OK    | c84e397193a54fe7-bbe9bc219318b75e | select 1              |
|                  |    1 | root | 127.0.0.1:34776 | 2025-01-21 12:01:07 | internal |      | Sleep   |   29 | EOF   | 886ffe2894314f50-8dd73a6ca06699e4 | show full processlist |
+------------------+------+------+-----------------+---------------------+----------+------+---------+------+-------+-----------------------------------+-----------------------+

查看所有连接（管理员权限）

SHOW FULL PROCESSLIST

运维实践建议

1. 性能监控：通过 Time 列可以识别长时间运行的查询，可能需要进行优化
2. 连接管理：Sleep 状态的连接过多可能表示连接池配置不当
3. 问题诊断：结合 State 和 Info 列可以分析查询阻塞或性能问题
4. 安全审计：通过 User 和 Host 列可以监控数据库访问来源

注意事项

1. Info 列默认只显示前100个字符，如需查看完整SQL语句，需要通过其他方式获取
2. 频繁执行 SHOW PROCESSLIST 可能会对系统性能产生轻微影响
3. 对于大型集群，返回结果可能较多，建议结合过滤条件使用

通过掌握 SHOW PROCESSLIST 命令，数据库管理员可以有效地监控Apache Doris数据库的运行状态，及时发现并解决潜在问题，保障数据库的稳定高效运行。