登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  数据库 >  Redis

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。

Redis COMMAND LIST FILTERBY PATTERN 命令名筛选关系说明图
图1:COMMAND LIST 与 PATTERN 命令名筛选关系的静态说明图,不是终端截图或运行结果。

把模式和结果一一对应起来

返回结果是一个数组,每一项是命令名,例如 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,也不会显示一个账号本来没有权限接触的服务能力。
Redis COMMAND LIST FILTERBY PATTERN 使用边界说明图
图2:版本、复杂度、权限和空结果的静态使用边界说明图,不是线上监控截图。

如果你的真正目标是找键名,应回到 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 子命令查询。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>