MySQL performance_schema.user_defined_functions 怎样读取已注册可加载函数的元数据
来源:17golang原创
时间:2026-11-18 14:07:20 181浏览 收藏
使用只读 SELECT 查询 performance_schema.user_defined_functions,可以读取当前注册的可加载函数名称、返回类型、标量或聚合类别、库文件以及当前使用计数。本文依据 MySQL 8.4 文档说明这些字段;它不是存储函数源码表,也不是函数耗时排行榜。
适合从一份注册清单开始:先记录实例与采集时间,再读取目标行,最后解释计数和空值。这样做能避免把“函数存在”“当前有语句使用”“执行很快”混成同一个结论。本文没有提供实测性能数字,也不要求安装或调用任何新的可加载函数。
官方文档地址:https://dev.mysql.com/doc/refman/8.4/en/performance-schema-user-defined-functions-table.html
先保存当前注册清单
先在有权读取该表的连接中查询。记录版本和采集时间是为了让后续比较有明确上下文,而不是认为 Performance Schema 中的所有表都保存累计性能数据。注册行可能随组件或插件变化,两个时点的清单不必相同。
-- 记录实例版本与采集时间,便于区分不同实例或不同批次。
SELECT VERSION() AS server_version, NOW() AS sampled_at;
-- 显式列出所需属性;排序只用于稳定展示,不代表调用顺序。
SELECT UDF_NAME, UDF_RETURN_TYPE, UDF_TYPE,
UDF_LIBRARY, UDF_USAGE_COUNT
FROM performance_schema.user_defined_functions
ORDER BY UDF_NAME;
保留完整表名可以避免默认数据库影响对象定位。示例不包含创建、删除或执行可加载函数的语句;读者应以自己的实例返回为准,本文未把查询示例作为本机运行结果。查询报错和查询成功但结果为空,需要分开记录。

按名称读取函数属性
从完整清单取得真实名称后,用等值条件查目标函数。下面的 business_normalize 仅为占位名称,不暗示实例已经安装这个函数。若没有匹配行,不要自动换成调用函数来试探,也不要仅凭名字猜测它属于某个组件。
-- 将示例名称替换为当前注册清单中的真实函数名。
SET @target_udf = 'business_normalize';
SELECT UDF_NAME, UDF_RETURN_TYPE, UDF_TYPE,
UDF_LIBRARY, UDF_USAGE_COUNT
FROM performance_schema.user_defined_functions
WHERE UDF_NAME = @target_udf;
-- 库文件为空的行单独展示,保留 NULL 的实际语义。
SELECT UDF_NAME, UDF_TYPE, UDF_LIBRARY
FROM performance_schema.user_defined_functions
WHERE UDF_LIBRARY IS NULL
ORDER BY UDF_NAME;
| 字段 | 阅读方式 |
|---|---|
| UDF_NAME | SQL 中引用的函数名;特定卸载阶段可能为空 |
| UDF_RETURN_TYPE | 函数返回值类别,不是 SQL 参数列表 |
| UDF_TYPE | 区分标量函数与聚合函数 |
| UDF_LIBRARY | 实现所在的库文件名,可能为空 |
| UDF_USAGE_COUNT | 当前使用计数,不是总调用次数 |
读取元数据时保持原始字段即可。不要把返回值类别解释成完整 SQL 列定义,也不要从这些列推出函数的业务行为、输入约束或是否适合某条业务语句。函数本身的使用方式仍要阅读对应组件或函数的说明。
把使用计数与性能指标分开
最容易误读的是 UDF_USAGE_COUNT:它用于观察当前是否有语句访问函数。一个时点看到零,不能推出“上线后从未调用”;看到非零,也不能直接算出每秒调用量或平均延迟。因此不适合把两次计数相减当作吞吐量。

如果要在变更前后观察这个表,可以沿用相同查询并保存采集时间,比较注册行和属性差异。这个动作只能回答清单是否变化、采样时的计数是什么,不能据此宣布某项优化提升了多少性能。性能问题还需要独立定义负载、耗时和测量方法,本篇不展开压测。
解释空值与来源差异
库文件字段为空不等于文件丢失。官方文档说明,由组件或插件注册的函数可以在这一列返回空值;通过语句注册的函数在卸载过程中,名称列也可能出现空值。显示时保留 NULL,不要无条件替换为“异常”。
同样,不能把系统表 mysql.func 当成同范围清单:它与此表覆盖的注册来源不同。为了阅读当前可加载函数注册情况,应优先使用本文的 Performance Schema 表,避免因另一个表中没看到记录就判定函数不存在。
该表不允许 TRUNCATE。整理注册清单无需清空表,也不应为了让计数归零去改动函数安装状态。如果出现权限不足或表不存在,先明确实例版本、表是否可用以及账户读取权限,再由管理员处理,不把这些错误记成空清单。
表名包含 user_defined,是否涵盖所有存储函数?
不是。这里讨论可加载函数,名称源于早期 UDF 叫法,不应据此扩大到所有 SQL 存储函数。
使用计数为零,能安全卸载吗?
单次采样不能证明后续没有业务依赖。卸载需要另外安排依赖确认和变更流程,不能由这个数字单独决定。
查询能直接返回函数实现代码吗?
不能。字段提供注册属性,库文件名也不是完整实现源码。
-
374 收藏
-
499 收藏
-
384 收藏
-
184 收藏
-
265 收藏
-
数据库 · MySQL | 1小时前 | MySQL · 主从复制 · mysql 故障转移 异步复制 Performance Schema replication_asynchronous_connection_failover167 收藏
-
数据库 · MySQL | 2小时前 | MySQL · 主从复制 · mysql Performance Schema replication_applier_global_filters 复制过滤器311 收藏
-
337 收藏
-
396 收藏
-
309 收藏
-
130 收藏
-
144 收藏
-
496 收藏
-
148 收藏
-
234 收藏
-
490 收藏
-
273 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习