Redis COMMAND LIST FILTERBY PATTERN 怎样按名称模式列出命令
如果你只想查看 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 子命令查询。
MySQL ST_PointN 怎样读取线串中的指定顶点
- 上一篇
- MySQL ST_PointN 怎样读取线串中的指定顶点
- 下一篇
- Go go/types.Alias.Origin 怎样找到实例化别名的原始声明
-
- 数据库 · Redis | 2小时前 | 数据库 · 故障排查 · redis RESP3 RESP2 CLIENT GETNAME Redis连接 Redis客户端名称
- Redis CLIENT GETNAME 怎样读取当前连接设置的名称
- 283浏览 收藏
-
- 数据库 · Redis | 13小时前 | Redis · redis idle Pending Entries List XCLAIM Redis Streams消息接管
- Redis XCLAIM IDLE 怎样重置待处理消息的空闲时间
- 491浏览 收藏
-
- 数据库 · Redis | 14小时前 | 数据类型 · Redis · RedisJSON JSONPath JSON.GET JSON.TYPE Redis JSON 类型判断
- RedisJSON JSON.TYPE 怎样判断路径对应的数据类型
- 309浏览 收藏
-
- 数据库 · Redis | 14小时前 |
- Redis CLIENT UNPAUSE 怎样恢复被暂停的连接
- 240浏览 收藏
-
- 数据库 · Redis | 14小时前 |
- Redis CLIENT SETINFO 怎样标记客户端名称和版本
- 254浏览 收藏
-
- 数据库 · Redis | 14小时前 |
- Redis Lua cjson.decode 解析 JSON 字符串的字段读取与错误处理
- 267浏览 收藏
-
- 数据库 · Redis | 14小时前 |
- Redis EVALSHA 怎样判断脚本是否已缓存
- 217浏览 收藏
-
- 数据库 · Redis | 14小时前 | 故障排查 · 模块管理 · redis MODULE LIST Redis模块
- Redis MODULE LIST 怎样查看已加载模块
- 273浏览 收藏
-
- 数据库 · Redis | 14小时前 |
- Redis COMMAND COUNT 怎样统计服务器支持的命令数量
- 229浏览 收藏
-
- 数据库 · Redis | 15小时前 | Redis · redis 引用计数 OBJECT REFCOUNT OBJECT命令 Redis排查
- Redis OBJECT REFCOUNT 怎样读取值对象的引用计数
- 211浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1093次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1089次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1254次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1197次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1042次使用
-
- Nginx 502 Bad Gateway 怎么排查:从 upstream 到应用端口一步步定位
- 2026-06-17 369浏览
-
- Go与Redis实现分布式互斥锁和红锁
- 2022-12-22 117浏览
-
- Go+Redis实现延迟队列实操
- 2023-02-23 426浏览
-
- 一文搞懂Go语言操作Redis的方法
- 2023-01-07 171浏览
-
- Golang分布式应用之Redis示例详解
- 2023-01-07 113浏览

