Redis COMMAND LIST FILTERBY PATTERN 怎样按名称模式列出命令
来源:17golang原创
时间:2026-11-18 11:54:05 121浏览 收藏
如果你只想查看 Redis 中名称符合某种模式的命令,可以使用 COMMAND LIST FILTERBY PATTERN。例如,想找出命令名以 H 开头的条目,可写成 COMMAND LIST FILTERBY PATTERN H*。它筛选的是 Redis 命令名,不是数据库里的键;返回值是命令名数组。
我在整理生产环境排查命令时,最容易把这个语法和 SCAN MATCH 混在一起。两者的对象完全不同:前者查看服务器命令表,后者查找键。本文只聚焦命令名模式筛选。
Redis 官方文档:https://redis.io/docs/latest/commands/command-list/
先确认 COMMAND LIST 的输入和返回
COMMAND LIST 从 Redis 7.0 开始提供,基本形式是 COMMAND LIST [FILTERBY 。不加过滤条件时,它返回服务器命令名列表;加上 PATTERN 后,服务端只保留与模式匹配的命令名。
| 部分 | 作用 | 不要误解成 |
|---|---|---|
COMMAND LIST | 读取服务器命令名列表 | 执行某个命令 |
FILTERBY PATTERN | 按 glob 风格模式筛选名字 | 正则表达式查询 |
| 返回数组 | 每项是一个命令名 | 命令的完整参数说明 |
官方文档给出的时间复杂度是 O(N),其中 N 是 Redis 命令总数。因此它适合命令发现、能力清单和排查,不应被当成高频业务路径上的缓存查询。
用 glob 模式列出命令
PATTERN 使用的是命令名匹配模式。常见写法是用 * 表示任意长度的字符,用 ? 表示单个字符;需要更细的筛选时,可以使用 glob 风格的字符组。模式要围绕命令名书写,不要把数据库键名放进来。
# 按命令名筛选:列出所有以 H 开头的命令 redis-cli COMMAND LIST FILTERBY PATTERN 'H*' # 按命令名筛选:列出包含 GET 片段的命令 redis-cli COMMAND LIST FILTERBY PATTERN '*GET*' # 单字符位置使用问号;引号避免通配符先被本地 shell 展开 redis-cli COMMAND LIST FILTERBY PATTERN 'GE?'
这里的单引号是 shell 层面的保护。若不加引号,某些 shell 会先尝试展开 *,Redis 收到的参数就可能已经不是原来的模式。通过客户端库发送时,则要把模式作为一个独立参数传给 COMMAND LIST。

把模式和结果一一对应起来
返回结果是一个数组,每一项是命令名,例如 H* 可能得到 HGET、HSET 等名称。结果的具体内容取决于当前 Redis 发行版、已加载模块以及服务器暴露的命令集合,所以文章中的示例只说明形状,不固定某一台服务器的完整列表。
# 下面是返回形状示意,不代表某台服务器的完整输出 1) "HGET" 2) "HSET" 3) "HDEL"
如果没有命令名匹配,得到空数组并不等于 Redis 出错;它通常表示模式没有命中当前服务器的命令集合。相反,如果命令本身写错、关键字顺序不符合语法,Redis 可能返回 ERR syntax error,这时应该先检查 FILTERBY、PATTERN 和模式参数是否各自独立。
MODULE、ACLCAT 与 PATTERN 不要混成一个参数
FILTERBY 后面有三类筛选入口:MODULE 按模块名筛选,ACLCAT 按 ACL 类别筛选,PATTERN 按命令名模式筛选。它们是同一个可选筛选位置的不同选择,不是把三个关键字连续拼接成一条复合表达式。
# 通过 PATTERN 选择命令名;这里不叠加 MODULE 或 ACLCAT redis-cli COMMAND LIST FILTERBY PATTERN 'CLIENT*' # 如果目标是 ACL 类别,应改用 ACLCAT;示例仅展示参数形状 redis-cli COMMAND LIST FILTERBY ACLCAT '@connection'
客户端库通常会把这些参数映射成选项对象或独立字段。以官方文档列出的客户端签名为例,Python、Node.js、Go 等客户端都将模块、类别、模式作为不同输入;不要把整个命令串当成一个字符串参数交给客户端封装。
把查询放进生产操作边界
这个命令属于连接相关类别,官方文档还标注了 @slow 和 @connection ACL 类别。生产排查时,我会先确认执行身份是否有读取这类命令元信息的权限,再决定是在主库、只读副本还是隔离的管理连接上查询。
- 版本边界:Redis 7.0 以前的服务器不应假定支持
COMMAND LIST这套语法。 - 性能边界:复杂度为
O(N),N 是命令总数;偶尔人工查询可以,别在请求链路中循环调用。 - 结果边界:空数组可能只是无匹配,不能把它当成连接失败。
- 安全边界:模式筛选不会绕过 ACL,也不会显示一个账号本来没有权限接触的服务能力。

如果你的真正目标是找键名,应回到 SCAN MATCH 一类键空间命令;如果目标是查看参数、标志或完整文档,则应继续使用 COMMAND INFO、COMMAND DOCS 等专门命令。COMMAND LIST FILTERBY PATTERN 的职责只到“列出符合名称模式的命令”为止。
Redis COMMAND LIST FILTERBY PATTERN 是正则吗?
不是。它使用 Redis 命令文档所说的 glob-style name pattern,写法和正则表达式的语义不要混用。
为什么返回空数组?
通常是模式没有命中当前服务器的命令名,也可能是你连接到的 Redis 版本或模块集合与预期不同;先区分空结果和语法错误。
能不能用它查 Redis 的键?
不能。它查的是服务器命令名;键名扫描应使用面向键空间的命令。
COMMAND LIST 会返回每个命令的参数说明吗?
不会。它返回命令名数组;参数、标志和文档信息要使用对应的 COMMAND 子命令查询。
-
369 收藏
-
117 收藏
-
426 收藏
-
171 收藏
-
113 收藏
-
283 收藏
-
491 收藏
-
309 收藏
-
240 收藏
-
254 收藏
-
267 收藏
-
217 收藏
-
374 收藏
-
273 收藏
-
229 收藏
-
211 收藏
-
471 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习