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

Redis FUNCTION LIST WITHCODE 怎样同时查看函数库信息与代码

来源:17golang原创

时间:2026-11-18 14:56:37 287浏览 收藏

执行 FUNCTION LIST WITHCODE,可以在函数库信息中同时获得库源码。若只关心某些库,使用 FUNCTION LIST LIBRARYNAME 'billing_*' WITHCODE 过滤库名。源码位于库层的 library_code 字段,不是给每个函数都返回一段独立源码。

这项命令从 Redis 7.0.0 起提供,本文介绍的是已有能力的实际读取方式,不把它包装成新发布事件。我会把“看有哪些库”和“查看某个库的代码”分成两种查询目的:前者不必每次带上源码,后者再加 WITHCODE,便于控制返回内容。

官方地址:https://redis.io/docs/latest/commands/function-list/

先确定要查看函数库还是单个函数

FUNCTION LIST 的组织单位是库。一个库有名称与引擎,并包含函数列表。假设某个业务库注册了多个函数,查看库源码时得到的是这个库整体的源代码,而不是按函数名拆分后的源码片段。

因此,已知一个函数名时,应先找到包含它的库,再理解库内注册关系。把函数名直接填到 LIBRARYNAME 后面,不会自动变成按函数名搜索。本文不要求重新加载库,也不需要调用业务函数来查看代码。

函数库元数据与函数列表的静态结构
结构说明图:库名称、引擎、源码与函数列表属于不同字段,图示只表达对象关系,不是命令输出截图。

用库名过滤并请求源码

在有权限执行该命令的连接中,可以使用下面的 redis-cli 示例。库名都是说明用名称,不代表目标实例已安装这些库;连接参数应使用自己的既有配置,避免把认证信息写进共享教程或日志。

# 使用已配置好连接和认证的redis-cli;示例不在命令行中写密码。
redis-cli FUNCTION LIST WITHCODE

# 库名过滤针对库而不是函数,通配符加引号防止被本地shell展开。
redis-cli FUNCTION LIST LIBRARYNAME 'billing_*' WITHCODE

# 已知确切库名时,将示例名称替换为真实名称。
redis-cli FUNCTION LIST LIBRARYNAME 'billing_rules' WITHCODE

通配符外的引号用于让 shell 原样传递模式,不是库名的一部分。若只是日常列清单,可省略 WITHCODE;当需要了解库内容或比较部署产物时再带上它。库名过滤也不是按源码内容搜索。

按库层与函数层读取回复

层次字段含义
库library_name库名称
库engine库使用的引擎
库functions库内函数集合
库library_code请求WITHCODE时附带的库源码
函数name、description、flags函数名称、描述和标记

读取时先按库组织,再进入 functions。description 是描述字段,不能当成源码;flags 是函数标记集合,也不是调用统计。将库源码保存为文本时,应保留换行与原有字符,不要用终端显示时的缩进编号去拼接代码。

WITHCODE选项与库源码字段的关联
结构说明图:源码字段在库层,函数条目各自保存名称与标记;不表示执行顺序或运行结果。

客户端对协议回复可能已有映射处理,终端展示与程序返回对象也可能不同。不要照着 redis-cli 的行号或缩进固定截取第几行。消费端应依据实际客户端的数据结构按字段取值,并处理源码未请求、库未匹配和命令返回错误三种不同情况。

保存查询结果时保留上下文

如果把查询内容交给同事排查,建议同时记录目标实例标识、查询时间、库名模式,以及是否包含 WITHCODE。只给出一段源码而不说明它来自哪里,很难判断它是否与预期部署对应。多库回复也不应被拼成一个没有库边界的大文本。

读取源码不等于执行源码,更不说明库中所有函数都已被调用。也不能把终端显示的库顺序当成依赖或执行顺序;比较两份清单时,先按库名与函数名对齐对象,再看字段差异。此处没有实测输出或性能数据。

WITHCODE 会增加返回的源码内容,不适合在只需名称的频繁清单查询中无条件使用。源码还可能包含业务实现细节,保存和共享时应遵守所在环境的访问约定。对权限错误应请求适当的读取授权,不通过重新加载或修改函数库来试探。

加WITHCODE会替换现有函数库吗?

不会。这里读取库信息和源码,不是加载或替换操作。

为什么不带WITHCODE时找不到library_code?

源码是按需附带的字段。先确认请求确实包含该选项,再按客户端返回结构读取。

能据此知道函数的调用次数吗?

不能。列表描述库和函数信息,字段不代表调用次数或平均耗时。

参考:Redis FUNCTION LIST 文档。

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