13518219792
1）基本用户定义函数是一类代码，对MYSQL服务器功能进行扩充，通过添加新函数，性质就象使用本地MYSQL函数abs()或concat().UDF是用C（或C++）写的。也许还可以用BASIC，.NET或其它什么虽然还没见过有人这么做。
公司主营业务：网站建设、网站制作、移动网站开发等业务。帮助企业客户真正实现互联网宣传，提高企业的竞争能力。创新互联是一支青春激扬、勤奋敬业、活力青春激扬、勤奋敬业、活力澎湃、和谐高效的团队。公司秉承以“开放、自由、严谨、自律”为核心的企业文化，感谢他们对我们的高要求，感谢他们从不同领域给我们带来的挑战，让我们激情的团队有机会用头脑与智慧不断的给客户带来惊喜。创新互联推出苏仙免费做网站回馈大家。
2）从字面上何以知道UDF是很有用的，尤其当需要扩展MYSQL服务器功能时。下表给出了最佳解决方法的比较：
Method Speed Language Development
方法 速度 语言 开发
Stored Procedures slow SQL ~minutes (for small functions)
存储过程 慢 SQL ~分钟（对于小函数）
UDF fast C ~hour
UDF 快 C ~小时
Native Function fast C major pain in the ***
本地函数 快 C 未知
慢的意思是和其它比较时。存储过程和一般SQL语句比仍然是很快的。
对本地函数的一点解释：本质上和UDF没太大区别。但是必须用MYSQL的资源代码来写然后重新编译全部。这将是很大的工作量，必须一边又一边的用最新版的MYSQL来完成这项工作。
3）这部分很简单。当完成了一个UDF，只是使用它就可以了。例如："SELECT MyFunction(data1, data2) FROM table"
4）编写UDF
现在开发写一个UDF：
建立一个新的shared-library项目（该例中用的VC++ 6.0建立一个标准的DLL）
首先需要一些头文件。这些头文件是标准的头文件和MYSQL服务器的包含目录里的文件
#ifdef STANDARD
/* STANDARD is defined, don't use any mysql functions */
#include
#include
#include
#ifdef __WIN__
typedef unsigned __int64 ulonglong; /* Microsofts 64 bit types */
typedef __int64 longlong;
#else
typedef unsigned long long ulonglong;
typedef long long longlong;
#endif /*__WIN__*/
#else
#include
#include
#endif
#include
#include
static pthread_mutex_t LOCK_hostname;
现在必须决定需要哪类函数。本质上有两种选择：
该函数是聚合函数吗？（后面将学习很多关于聚合函数的内容）
返回类型是什么？有4个选择：
类型 描述
STRING 一个合法的字符串，转换成char*类型
INTEGER 一个普通的整型变量，转换成64位的整型
REAL型 一个俘点数，转换成double型
DECIAML型 这个并没真正的结束，MYSQL将做字符串对待
现在开始讨论关于非聚合函数。必须声明并执行一些MYSQL使用UDF时用到的函数，但首先一些必要的结构必须并确：
UDF_INIT:
类型 名称 描述
my_bool maybe_null 是1如果函数能返回NULL
unsigned int decimals 针对REAL函数
unsigned long max_length 针对字符串函数
char * ptr 自由指针针对函数的数据
my_bool const_item 0如果结果是独立的
UDF_ARGS:
类型 名称 描述
unsigned int arg_count 成员数量
enum Item_result * arg_type 成员类型的数组
char ** args 指向成员的指针的数组
unsigned long * lengths 成员长度的数组（针对字符串）
char * maybe_null "maybe_null"标记的数组
char ** attributes 指向成员属性的指针的数组
unsigned long * attribute_lengths 属性长度数组
现在看一下该函数：
De-/Initialization:
Collapseextern "C" my_bool MyTest_init(UDF_INIT *initid, UDF_ARGS *args,
char *message)
{
//非常重要的一件事是建立内存
//需要
//需要一个很长的变量来保存检测数
//虽然该例中不需要
longlong* i = new longlong; // 建立变量
*i = 0; // 设初值
//指针变量中保存为一个字符指针
//确认不会遇到类型问题
initid-ptr = (char*)i;
//检测成员的格式
if (args-arg_count != 1)
{
strcpy(message,"MyTest() requires one arguments");
return 1;
}
if (args-arg_type[0] != INT_RESULT)
{
strcpy(message,"MyTest() requires an integer");
return 1;
}
return 0;
}
extern "C" void MyTest_deinit(UDF_INIT *initid)
{
//这里必须清空所分配的内存
//引入函数
delete (longlong*)initid-ptr;
}
The actual function:
extern "C" longlong MyTest(UDF_INIT *initid, UDF_ARGS *args,
char *is_null, char *error)
{
/*最后这是实际的工作部分。该函数为每个记录调用，返回值或指向当前值的指针保存在UDF_ARGS变量中。必须获得值，完成计算并返回值。注意可以通过UDF_INIT变量进入MyTest_init中分配的内存，该例中将为每个值设置为5
*/
return *((longlong*)args-args[0])+5;
}
全部完成！现在必须编译连接库，然后将其拷贝到操作系统可以加载的目录下。通常在WINDOWS里是系统变量的定义路径。个人使用的是MYSQL服务器的bin目录。必须确认该目录是其它MYSQL不能访问的。然后确认所有MYSQL需要的函数功能。
必须告诉MYSQL，这必须直接了当：执行以下SQL指令：
CREATE [AGGREGATE] FUNCTION MyTest
RETURNS [INTEGER|STRING|REAL|DECIMAL] SONAME the_libraries_exact_name
现在可以想使用其他函数一样使用它了。
5）成员函数：
现在说一下成员函数。当的UDF是个成员函数，必须增加一些函数，一些函数在不同的方式中使用。调用次序是：
调用yTest_init来分配内存（就象一般的UDF一样）
MYSQL将表分类是通过GROUP BY
每组里的第一行调用MyTest_clear
每组里的第一列调用 MyTest_add
在组改变后或最后一列改变后调用MyTest得到结果
重复3到5直到所有列被处理。
调用MyTest_deinit清空内存
现在让看一下新的聚合函数所需的函数。该例中将简单的添加所有的值。（就象本地SUM函数）
void MyTest_clear(UDF_INIT *initid, char *is_null, char *error)
{
/*为每个新组重新将总数设置为0，当然必须分配一个longlong类型变量在在init函数中，并分配给指针
*/
*((longlong*)initid-ptr) = 0;
}
void MyTest_add(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error)
{
//为每列将当前值添加到总数
*((longlong*)initid-ptr) = *((longlong*)initid-ptr) +
*((longlong*)args-args[0]);
}
longlong MyTest(UDF_INIT *initid, UDF_ARGS *args, char *is_null, char *error)
{
//最后返回总值
return *((longlong*)initid-ptr);
}
6）更进一步的问题：
在写一些复杂的UDF时需要注意几个问题：
一个字符串函数应该返回一个指向结果的指针并且设置*result和*length作为目录和返回值的长度值。例如：
memcpy(result, "result string", 13);
*length = 13;
MyTest建立的结果缓冲区是255字节。如果的结果保存在里面。不必担心结果的内存分配问题。
如果的字符串函数需要返回一个大于255字节长度的字符串。必须用malloc或新的MyTest_init或MyTest函数分配，然后用MyTest_deinit释放它。能用UDF_INIT的指针保存分配的内存地址，并在MyTest中重用。
在主函数中指定一个错误返回，设置 *error为1：如果MyTest()为任何列将*error设置为1，则函数的值是NULL针对于当前列，以及对任何的通过MyTest()被调用的声明中并发的列请求。
想了解更多内容看一下MYSQL在线帮助。
7）一些指导方针：
如果确实希望的UDF运行良好，这里有一些建议：）
不要在UDF中调用任何其他的程序或进程
不要保存任何的本地信息。（这些在普通的库里已经共享）
不要分配任何的全局或静态的变量。
始终检测成员的类型。就象MYSQL将所有类型都转换为字符类型。如果将一个字符类型转换成整型指针可能会出错。
特别注意内存的分配。如果有内存泄漏问题会使服务器彻底崩溃！
8）调式UDF
调试UDF需要勇气因为如果UDF有问题，每次都会使整个MYSQL服务器死掉。所以写了一个命令行工具，来围绕这个问题工作。仅仅运行它，它会模仿"SELECT"调用指令将结果保存到库文件中，可以打印所有的结果行。所以当UDF存在一些错误只是该程序崩溃而不会是整个服务器。
用vs code 就可以了。
Visual Studio Code
Visual Studio Code（简称VS Code）是由微软开发的，同时支持Windows、Linux和macOS操作系统的开源文本编辑器。它支持调试，内置了Git 版本控制功能，同时也具有开发环境功能，例如代码补全（类似于IntelliSense）、代码片段、代码重构等。该编辑器支持用户自定义配置，例如改变主题颜色、键盘快捷方式、编辑器属性和其他参数，还支持扩展程序并在编辑器中内置了扩展程序管理的功能。
安装LLDB
LLDB是LLVM编译器的一部分，推荐使用Homebrew安装LLVM工具集，不建议使用系统自带的LLDB，安装前必须先创建证书否则无法安装，步骤如下：
创建完成后，开始安装LLVM
brew install llvm --with-python@2 --with-lldb
安装插件
VS Code自带有debug功能，这里我推荐使用LLDB Debugger插件。
接下来，为项目配置调试参数。
配置调试参数
使用VS Code打开MySQL源码目录，在侧边栏选择debug栏目，添加配置，program输入需要调试的程序路径，这里选择你编译好的mysqld路径，args输入程序启动所需的参数，通常会指定mysqld的配置文件。这样就配置好了，是不是很简单。
启动调试
点击启动按钮，启动后如果没有设置断点会mysqld会正常启动，如果触发了断点会如下图显示。
整个调试窗口基本分为六部分，所有的调试操作都在这里完成:
1: 显示变量信息
2: 设置重点关注的变量
3: 显示调用栈信息
4: 设置断点信息，在代码行号前也可以设置断点
5: 代码显示区域，上方是调试按钮，包括 continue/stepover/step in/step out/restart/stop
6: 调试终端输入输出区
断点设置
在代码行号前点击即可在该行为设置断点，也可以根据条件设置断点。以设置ConditionalBreakpoint为例，当程序启动后会按照你设置的条件表达式判断是否触发断点。
Conditional Breakpoint这种方式用在目标变量达到某条件时触发断点，其余则跳过继续执行。比如：设置变量等于目标表名时触发断点，其余表则跳过，相对函数名断点省去很多手工跳过操作。
远程调试
假如你想调试远程Linux服务器上的MySQL上面的方法就不合适了，这时需要远程调试。lldb和gdb都支持远程调试，这里以lldb为例。
需要先在远程主机上安装lldb，使用yum安装，源地址在这里
remote$ yum install -y llvm-toolset-7
安装完成后，启动lldb-server
remote$ /opt/rh/llvm-toolset-7/root/usr/bin/lldb-serverplatform --listen "*:9191" --server
接下来，在VS Code调试界面中新增配置项。
{
"type": "lldb",
"request": "attach",
"name": "Remote attach",
"program": "~/mysql5626/usr/local/mysql/bin/mysqld",
"pid":"target_pid",
"initCommands": [
"platform select remote-linux",
"platform connect connect://remote_host:9191"
],
"sourceMap": {
"/export/home/pb2/build/sb_0-15908961-1436910670.17/mysql-5.6.26": "/Users/hongbin/workbench/mysql-server"
}
},
program: 本机也要拷贝一份目标程序，加载
pid: 填写远程主机的mysqld进程id
sourceMap: 填写mysqld编译的代码路径与本机代码库路径的映射，这样调试时代码才可以和程序关联在一起看
注意：记得调试前将代码切换到与目标程序版本一致的branch
• create procedure用来创建 存储过程 ，create function用来创建 函数
• Delimiter命令是改变语句的结束符 ，MySQL默认的结束符为;号，由于procedure和function中的;号并不代表创建的结束，所以要替换成另外的结束符以便表示创建的结束
• rontine_body子句可以包含一个简单的SQL语句，也可以包含多个SQL语句， 通过begin…end将这多个SQL语句 包含在一起
• MySQL存储过程和函数中也可以包含类似create和drop等DDL语句
• comment子句用来写入对存储过程和函数的注释
• Language子句用来表示此存储过程和函数的创建语言
• 存储过程和函数被标注为deterministic表明当输入相同的参数是会返回相同的结果，反之如果是not deterministic则表示相同参数不会是相同结果，默认是not deterministic
• 相关属性短语只有咨询含义，并不是强制性的约束
• Drop procedure/function语句用来 删除指定名称的存储过程或函数
• Begin…end语句通常出现在存储过程、函数和触发器中，其中 可以包含一个或多个语句 ，每个语句用;号隔开
• 标签label可以加在begin…end语句以及loop, repeat和while语句
• 语句中通过iterate和leave来控制流程，iterate表示返回指定标签位置，leave表示跳出标签
• Declare语句通常用来声明本地变量、游标、条件或者handler
• Declare语句只允许出现在begin … end语句中而且必须出现在第一行
• Declare的顺序也有要求，通常是先声明本地变量，再是游标，然后是条件和handler
• 本地变量可以通过declare语句进行声明
• 声明后的变量可以通过select … into var_list进行赋值，或者通过set语句赋值，或者通过定义游标并使用fetch … into var_list赋值
• 通过declare声明变量方法：
• MySQL支持if,case,iterate,leave,loop,while,repeat语句作为存储过程和函数中的 流程控制语句 ，另外return语句也是函数中的特定流程控制语句
• Case语句在存储过程或函数中表明了 复杂的条件选择语句
• IF语句在存储过程或函数中表明了 基础的条件选择语句
其中在 function 里面，只有 DETERMINISTIC, NO SQL 和 READS SQL DATA 被支持。如果我们开启了 bin-log, 我们就必须为我们的 function 指定一个参数。
在 MySQL 中创建函数时出现这种错误的解决方法：
set global log_bin_trust_function_creators=TRUE;
• Iterate语句 仅出现在loop,repeat,while循环语句中，其含义表示重新开始此循环
• Leave语句表明 退出指定标签的流程控制语句块
• 通常会用在begin…end，以及loop,repeat,while的循环语句中
• Loop语句是存储过程或函数中表达 循环执行 的一种方式
• repeat语句是存储过程或函数中表达 循环执行 的一种方式
• while语句是存储过程或函数中表达 循环执行 的一种方式
• Return语句用在 函数中，用来终结函数的执行并将指定值返回给调用者
• Cursor游标用来 声明一个数据集
• 游标的声明必须在变量和条件声明之后，在handler声明之前
• Cursor close语句用来 关闭之前打开的游标
• Cursor declare语句用来声明一个游标和指定游标对应的数据集合， 通常数据集合是一个select语句
• Cursor fetch语句用来获取游标指定数据集的 下一行数据 并将各个字段值赋予后面的变量
• Open cursor语句用来打开一个之前已经 声明好的游标
• Declare condition语句命名 特定的错误条件 ，而该特定错误可以在declare…handler中指定 处理方法
• 比如在MySQL中1051error code表示的是unknown table的错误，如果要对这
个错误做特殊处理，可以用三种方法：
• Declare handler语句用来声明一个handler来处理一个或多个特殊条件，当其中的某个条件满足时则触发其中的statement语句执行
• Statement可以是一个简单SQL语句，也可以是begin…end组成的多个语句
• Handler_action子句声明当执行完statement语句之后应该怎么办
Condition_value的值有以下几种：
• 当condition发生但没有声明handler时，则存储过程和函数依照如下规则处理
• create trigger语句用来创建一个触发器，触发器的作用是当表上有对应SQL语句发生时，则触发执行
• 触发器创建时需要 指定对应的表名 tbl_name
• Definer关键词用来指定trigger的安全环境
• Trigger_time指定触发器的执行时间，BEFORE和AFTER指定触发器在表中的 每行数据修改前或者后 执行
• Trigger_event指定触发该触发器的具体 事件
• INSERT当新的一行数据插入表中时触发，比如通过执行insert,load data,replace语句插入新数据
• UPDATE当表的一行数据被修改时触发，比如执行update语句时
• DELETE当表的一行数据被删除时触发，比如执行delete,replace语句时
• 当执行insert into … on duplicate key update语句时，当碰到重复行执行update时，则触发update下的触发器
• 从5.7.2版本开始，可以创建具有相同trigger_time和trigger_event的同一个表上的多个触发器，默认情况下按照创建的时间依次执行，通过 指定FOLLOWS/PRECEDES改变执行顺序 ，即FOLLOWS时表示新创建的触发器后执行，PRECEDES则表示新触发器先执行
• Trigger_body表示触发器触发之后要执行的一个或多个语句，在内部可以引用涉及表的字段， OLD.col_name表示行数据被修改或删除之前的字段数据，NEW.col_name表示行数据被插入或修改之后的字段数据
• Drop trigger语句用来 删除一个触发器
• If exists短语用来避免删除不存在的触发器时引发报错
• 当你执行drop table时，表上的触发器也被drop掉了
调用如：select 函数名（参数列表）。
mysql中的UDF（自定义函数），可以写好一些方法或 函数，然后进行调用，而且是在SQL语句中可以进行调用。
DROP FUNCTION CalculateAmount
CREATE FUNCTION CalculateAmount(userid INT) RETURNS float(10,2)
BEGIN
DECLARE totalCredits FLOAT;
SELECT SUM(amount) INTO totalAmount FROM credit_user WHERE id =userid;
RETURN totalAmount;
END
要注意的是，在UDF中，不要定义与数据表中重名的列。而在SQL中， 则可以像SELECT CalculateAmount(1)；那样去调用了。
