MySQL自定义函数(Stored Function)就是你自己封装的一段可复用逻辑,定义后能像 NOW()、CONCAT() 这些内置函数一样,直接在 SQL 里调用,比如 SELECT get_score_level(86)。它主要用于轻量的计算、格式化和数据转换,核心特点就是必须返回一个值,而且只能返回一个。
前言
在MySQL中,很多人会混淆**自定义函数(UDF,用户自定义函数)**和存储过程,二者虽然都属于数据库可编程对象,但使用场景、语法限制、调用方式差异很大。
内置函数如SUM()、DATE_FORMAT()可以直接拿来用,但如果业务有固定的计算逻辑、格式化规则,反复写重复SQL就很繁琐,这时就可以自己编写MySQL自定义函数,封装逻辑,一行调用。
注意:MySQL自定义函数有返回值,必须返回单个值;不能返回结果集,这是和存储过程最核心的区别。
一、自定义函数基础语法
创建函数
|
1
2
3
4
5
6
7
8
9
|
DELIMITER //
CREATE FUNCTION 函数名(参数名 参数类型)
RETURNS 返回值类型
[DETERMINISTIC]
BEGIN
-- 函数业务逻辑
RETURN 返回的数据;
END //
DELIMITER ;
|
关键字说明:
- DELIMITER //:修改语句结束符。默认MySQL以;作为结束标记,函数体内部会用到分号,所以临时改成//,函数创建完成再恢复;。
- CREATE FUNCTION:创建自定义函数。
- 入参:只支持IN输入参数,没有OUT、INOUT参数(存储过程才有)。
- RETURNS:必须声明返回值的数据类型,int、varchar、datetime等。
- DETERMINISTIC(可选):确定函数。相同输入一定返回相同结果,不读随机数、当前时间这类动态数据,开启有助于优化器优化。
- RETURN:函数内部必须有return语句,返回结果。
查看、删除函数
|
1
2
3
4
|
-- 查看数据库下所有自定义函数
SHOW FUNCTION STATUS WHERE Db = '你的数据库名';
-- 删除自定义函数
DROP FUNCTION IF EXISTS 函数名;
|
二、简单实战示例
示例1:最简单的数字计算函数
需求:传入分数,返回等级。比如 >=90优秀,>=80良好,>=60及格,其余不及格。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
|
DELIMITER //
CREATE FUNCTION get_score_level(score INT)
RETURNS VARCHAR(20)
DETERMINISTIC
BEGIN
DECLARE level VARCHAR(20);
IF score >= 90 THEN
SET level = '优秀';
ELSEIF score >= 80 THEN
SET level = '良好';
ELSEIF score >= 60 THEN
SET level = '及格';
ELSE
SET level = '不及格';
END IF;
RETURN level;
END //
DELIMITER ;
|
调用方式(和内置函数一样,放在select里)
|
1
2
3
|
SELECT get_score_level(86);
-- 结合表查询
SELECT name, score, get_score_level(score) AS level FROM student;
|
示例2:文本处理函数
需求:传入字符串,去掉多余空格,转为大写返回
|
1
2
3
4
5
6
7
8
|
DELIMITER //
CREATE FUNCTION str_upper_trim(str VARCHAR(255))
RETURNS VARCHAR(255)
DETERMINISTIC
BEGIN
RETURN UPPER(TRIM(str));
END //
DELIMITER ;
|
调用:
|
1
|
SELECT str_upper_trim(' hello mysql ');
|
三、自定义函数 VS 存储过程(重点区分)
| 对比项 |
自定义函数Function |
存储过程Procedure |
| 返回值 |
必须有且只能返回单个值 |
无返回值,可以用OUT输出多个参数 |
| 调用方式 |
select 函数() |
call 存储过程() |
| 参数类型 |
仅支持IN输入参数 |
支持IN/OUT/INOUT三种参数 |
| 返回结果集 |
不能返回多行结果集 |
可以查询返回结果集 |
| 事务 |
不建议在函数内使用事务 |
支持事务、复杂业务逻辑 |
| 使用场景 |
简单计算、字段格式化、转换 |
批量DML、复杂多步骤业务 |
一句话总结:简单计算、字段转换用自定义函数;多表更新、批量操作、复杂业务流程用存储过程。
四、适用场景
- 字段格式化:统一对日期、文本、编码做清洗转换,查询时直接调用,避免每个SQL重复写一堆CASE、字符串处理逻辑。
- 固定规则计算:分数评级、税率计算、编码生成,规则写在函数里,后续修改只改函数,不用改所有业务SQL。
- 复杂字段判断:多条件的标签判定,比如根据金额、时间自动打业务标签。
五、重要限制与避坑
- 禁止在函数里做DML操作(insert/update/delete),容易出现锁、主从同步异常,MySQL不推荐,部分版本直接限制。
- 不能返回多行数据,想查询多条记录不能用自定义函数,改用存储过程。
- 函数内尽量避免查询大表,函数会每行都执行,放在WHERE或者SELECT字段里,大数据量极易性能雪崩。
- 权限问题:创建函数需要 CREATE ROUTINE 权限,线上数据库最小权限原则,不要随意开放。
- 注意字符集、长度,varchar类型如果返回内容超出定义长度会截断。
六、什么时候不要用自定义函数
- 需要批量新增、更新、删除数据 → 存储过程
- 需要返回多行查询结果 → 存储过程
- 逻辑很重、关联多张大表 → 尽量写原生SQL,函数会造成每行执行,索引失效风险高
- 逻辑经常频繁变更:函数修改需要DDL锁,高并发生产环境要谨慎。
结尾
MySQL自定义函数适合封装轻量、无副作用的计算转换逻辑,使用简单,调用方式和内置函数保持一致。但它不是万能的,千万不要把复杂业务全部塞进函数,尤其是大数据量查询场景,很容易引发性能问题。开发前分清函数和存储过程的适用边界,才能发挥它的价值。
|