当前位置:首页 > 文章列表 > 数据库 > Redis > Redis COMMAND LIST FILTERBY PATTERN 怎样按名称模式列出命令

Redis COMMAND LIST FILTERBY PATTERN 怎样按名称模式列出命令

来源:17golang原创 2026-11-18 11:54:05 0浏览 收藏

如果你只想查看 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删除
MySQL ST_PointN 怎样读取线串中的指定顶点MySQL ST_PointN 怎样读取线串中的指定顶点
上一篇
MySQL ST_PointN 怎样读取线串中的指定顶点
Go go/types.Alias.Origin 怎样找到实例化别名的原始声明
下一篇
Go go/types.Alias.Origin 怎样找到实例化别名的原始声明
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1093次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1089次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1254次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1197次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1042次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码