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

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_NAMESQL 中引用的函数名;特定卸载阶段可能为空
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 存储函数。

使用计数为零,能安全卸载吗?

单次采样不能证明后续没有业务依赖。卸载需要另外安排依赖确认和变更流程,不能由这个数字单独决定。

查询能直接返回函数实现代码吗?

不能。字段提供注册属性,库文件名也不是完整实现源码。

参考:MySQL 8.4:user_defined_functions 表。

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