0

0

mysql中用户定义函数(UDF)的创建与使用

P粉602998670

P粉602998670

发布时间:2026-01-08 04:51:11

|

345人浏览过

|

来源于php中文网

原创

MySQL UDF 必须用 C/C++ 编写并编译为动态库,通过 CREATE FUNCTION ... SONAME 注册;不可用 SQL 或存储过程替代,且需严格遵循类型约定、符号导出和初始化函数规范。

mysql中用户定义函数(udf)的创建与使用

MySQL UDF 必须用 C/C++ 编写,不能用 SQL 或存储过程替代

MySQL 的 CREATE FUNCTION 语句只支持**外部编译的 C/C++ 函数**(即真正的 UDF),和存储函数(CREATE FUNCTION ... RETURNS ... BEGIN ... END)完全不同。后者是 SQL 层的存储例程,不叫 UDF,也不涉及动态库加载。如果你看到“用 SQL 写 UDF”,那一定是混淆了概念。

真实 UDF 流程是:写 C 源码 → 编译成 .so(Linux)或 .dll(Windows)→ 放到 MySQL 插件目录 → 用 CREATE FUNCTION ... SONAME 'xxx.so' 注册 → 才能在 SQL 中调用。

  • MySQL 不校验 C 函数签名,但必须严格遵循 my_boollong longchar * 等类型约定,否则启动时可能崩溃或调用失败
  • mysql_config --plugindir 是插件路径权威来源,别硬写 /usr/lib/mysql/plugin —— 不同发行版路径不同
  • UDF 函数名在 SQL 中全局可见,且不能与内置函数重名(如 my_abs 可以,abs 会报错)

注册 UDF 前必须确保函数符号可被动态链接器找到

编译时漏掉 -fPIC -shared 或导出符号不正确,会导致 ERROR 1126 (HY000): Can't open shared library 'xxx.so'。这不是权限问题,而是符号表缺失。

典型编译命令(Linux x86_64):

gcc -fPIC -shared -I$(mysql_config --include) -o myudf.so myudf.c
  • 必须用 mysql_config --include 获取头文件路径,否则找不到 mysql.h
  • C 源码中必须显式声明函数为 extern "C"(C++ 时),否则 C++ name mangling 会让符号名变成 _Z8myaddintS_ 这类不可识别形式
  • nm -D myudf.so 检查导出符号:应看到 myadd(你的函数名)、myadd_initmyadd_deinit 三个符号

UDF 初始化函数(xxx_init)返回非零值会导致 CREATE FUNCTION 失败

MySQL 在注册时会调用你的 xxx_init 函数做参数校验和资源预分配。如果它返回非零(比如 return 1;),CREATE FUNCTION 就直接报错 ERROR 1123 (HY000): Can't initialize function 'xxx',不会继续执行。

极限网络办公Office Automation
极限网络办公Office Automation

专为中小型企业定制的网络办公软件,富有竞争力的十大特性: 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装,建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件,使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件,提供web方式的远程邮件服务。 4、集成语音会议组件,节省长途话费开支。 5、集成手机短信组件,重要信息可直接发送到员工手机。 6、集成网络硬

下载

常见错误写法:

my_bool myadd_init(UDF_INIT *initid, UDF_ARGS *args, char *message) {
    if (args->arg_count != 2) {
        strcpy(message, "myadd() requires exactly two arguments");
        return 1; // ← 错!这里应 return 1 仅表示失败,但 message 必须以 \0 结尾且 ≤ 255 字节
    }
    initid->maybe_null = 0;
    return 0; // ← 成功返回 0
}
  • message 缓冲区大小固定为 256 字节,写超会内存越界
  • 即使你不需要初始化逻辑,也必须定义 xxx_initxxx_deinit,哪怕内容是空的 return 0;
  • args->args[i]char ** 类型指针数组,实际值需通过 args->args[i] != NULL ? *(args->args[i]) : NULL 解引用

UDF 调用时无法访问表数据或执行 SQL,也不能加锁或阻塞

UDF 运行在 MySQL 服务线程上下文中,但它**不是存储过程,没有 SQL 执行能力**。你不能在 UDF 里调用 mysql_query()、打开新连接、读写表、或使用 pthread_mutex_lock()——这些操作会破坏 MySQL 内部状态,轻则报错,重则导致 mysqld crash。

它的唯一职责是:接收参数 → 计算 → 返回结果。所有输入必须由 SQL 语句显式传入(如 SELECT myudf(col1, col2) FROM t)。

  • 若需查表逻辑,请改用存储函数 + 视图 + 应用层组合,而非强行塞进 UDF
  • 全局变量或静态缓冲区在多线程下不安全,MySQL 可能并发调用同一 UDF;必须用线程局部存储(__thread)或传参方式隔离状态
  • 耗时过长的 UDF(如网络请求、大循环)会卡住整个查询线程,影响并发性能,这类场景应避免

真正用到 UDF 的场景其实很窄:高性能数学计算(如地理距离哈希)、特殊编码解码(base91、xxhash)、硬件加速接口(如 AES-NI 封装)。日常开发中,99% 的需求用原生函数或应用层处理更稳妥。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

676

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

320

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

346

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

1093

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

357

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

674

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

571

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

412

2024.04.29

java学习网站推荐汇总
java学习网站推荐汇总

本专题整合了java学习网站相关内容,阅读专题下面的文章了解更多详细内容。

6

2026.01.08

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.7万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 785人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号