测试位于 mysql-test/t/*.test

测试案例包括终止声明，测试案例类似于mysql命令行客户端的输入。 默认的声明是一个被发送到 MySQL 服务器的查询，除非这个声明被识别为内部命令 (如 sleep)。

所有产生结果的查询，例如 SELECT, SHOW, EXPLAIN 等，必须在 @/path/to/result/file之前。那个文件必须包含期望的结果。生成结果文件的一个简单办法是在 mysql-test 目录运行mysqltest -r < t/test-case-name.test ，然后编辑生成的结果文件，如果需要，可将它们调整到想要的输出端。在那种情况下，要小心避免添加或删除任何不可见的字符，确保只改变文本和 (或) 删除行。如果插入一行，要确保插入的区域被一个硬标识隔开，且在行尾有一个硬标识。你可能会想要使用od -c来确保你的文本编辑器在编辑 步骤中没有搞乱任何东西。当你发现一个缺陷而不得不编辑mysqltest -r的输出时，我们真希望你不要编辑它。

为和我们的设置一致，你应该把你的结果文件放在 mysql-test/r 目录，并取名为 test_name.result。如果测试产生不止一个结果，你应该使用诸如 test_name.a.result，test_name.b.result 等这样的名字。

如果声明返回一个错误，你可以在声明的前一行使用--error error-number 来详细说明它。错误号可能是由“,”分开的可能错误号的列表。

如果你正编写一个重复的测试案例，你应该在测试文件的第一行写：source include/master-slave.inc;。用 connection master；和 connection slave；来切换主案例和从案例。如果你需要对一个替换的连接做点什么，对于主连接，用 connection master1;，对于从连接，用 connection slave1;。

如果需要在一个循环里做点什么，可以用些这样的内容：

let $1=1000;
while ($ 1)
{
 # do your queries here
 dec $1;
}

在查询之间休眠，使用sleep命令。此命令支持几分之几秒，所以，例如你想要休眠 1.3 秒，你可以使用sleep 1.3; 命令。

对你的测试案例要运行带附加选项的从案例，以命令行方式把它们放在 mysql-test/t/test_name-slave.opt。对于主案例，把它们放在 mysql-test/t/test_name-master.opt。

如果对测试套件有问题，和想要献出一个测试案例，发送邮件信息到 MySQL 内部插件 邮件列表。请参阅1.7.1.1 节，“MySQL 邮件列表”。 虽然这个列表不接受附件，你可以把相关文件通过 ftp 上传到：ftp://ftp.mysql.com/pub/mysql/upload/

在尽可能多地找到出错之时的错误之前，不要发送缺陷报告。查找之时，请使用mysqlbug脚本比便我们能获取你的系统和 MySQL 版本信息，参阅1.7.1.3 节 ，“如何报告缺陷或问题”。

确保包含了mysql-test-run的输出，以及  mysql-test/r 目录下所有.reject文件的内容。

如果测试套件里的测试未通过，用如下命令检查一下看它自己运行时是否通过测试：

cd mysql-test
mysql-test-run --local test-name

如果未能通过，你应该用 --with-debug 配置 MySQL 并使用--debug 选项来运行mysql-test-run。如果这样也未能通过，请把追踪文件var/tmp/master.trace 上传到 ftp://ftp.mysql.com/pub/mysql/upload/ 以便我们能检查它。请记得也要包含你系统的完整描述，mysqld 二进制文件的版本，以及你是如何编译它的。

也试着带--force 选项运行一下mysql-test-run ，看是否还有别的测试未通过。

如果你是自己编译的 MySQL，查看我们的手册看看如何在你的平台上编译 MySQL，最好用一个在http://dev.mysql.com/downloads/上我们已经为你编译好的二进制版本。我们所有标准的二进制版本都能通过测试套件的测试！

如果错误是 Result length mismatch 或 Result content mismatch ，这意味测试的输出于期望的输出不匹配，这可能是在 MySQL 或你的mysqld 版本里的缺陷在某些环境下产生稍有不同的结果。

未通过的测试结果放在和结果文件同主名但扩展名为。reject 的文件里。如果测试案例未通过，你应该对两个文件做 diff 操作。如果你不能发现它们是如何不同，用 od -c 命令检查它们，也检查一下文件长度。

如果测试完全未通过，你应该检查 mysql-test/var/log 目录下的日志文件以获得有关错误的一些提示。

如果你是为调试而编译 MySQL，试一下带--gdb 和 (或)--debug 参数运行mysql-test-run 。请参阅E.1.2 节，“创建跟踪文件”。

如果你没有为调试而编译 MySQL，这应该是你可能去做的。只要带－-with-debug 参数运行configure。 请参阅2.8 节，“使用源码分发版安装 MySQL ”。

my_bool maybe_null

如果 xxx() 能返回 NULL，xxx_init() 应 maybe_null 为 1 。如果任一参量被说明了 maybe_null 值，其 默认值是 1 。

unsigned int decimals

小数位数。默认值是传到主函数的参量里小数的最大位数。(例如，如果函数传递 1.34, 1.345, 和 1.3，那么默认值为，因为 1.345 有 3 位小数。

unsigned int max_length

结果的最大长度。max_length 的默认值因函数的结果类型而异。对字符串函数，默认值是最长参量的长度。对整型函数，默认是 21 位。对实型函数，默认是 13 再加上 initid->decimals 指示的小数位数。(对数字函数，长度包含正负号或者小数点符)。

如果想返回团值，你可以把 max_length 设为从 65KB 到 16MB。这个内存不会被分配，但是如果有临时数据需要存储，这个设置了的值被用来决定使用哪种 列的类型。

char *ptr

函数可以用作本身目的的指针。比如，函数可以用 initid->ptr 来在分配了的内存内部通讯。 xxx_init() 应该分配内存，并指派给这个指针：

initid->ptr = allocated_memory;

在 xxx() 和 xxx_deinit() 中，借用 initid->ptr 来使用或分配内存。

xxx_reset()

当 MySQL 在一个新组中发现第一行时调用这个函数。它对这个组重置任何内部总和变量，然后使用给定的 UDF_ARGS 参量作为内部总和值的第一个值。如下说明 xxx_reset() 函数：

char *xxx_reset(UDF_INIT *initid, UDF_ARGS *args,
                char *is_null, char *error);

 ；在 MySQL5.1 版中 UDF 接口不需要或不使用 xxx_reset() 函数，而是使用 xxx_clear() 函数作为替代。但是如果你想让 UDF 也能在老版本的服务器上运行，你也可以定义 xxx_reset() 和 xxx_clear() 函数。(如果你使用了这两个函数，xxx_reset() 函数在很多情况下可以通过调用函数来内部实现，即调用 xxx_clear() 函数重置所有变量，然后添加 UDF_ARGS 参量作为组的第一个值。)

xxx_clear()

当 MySQL 需要重置总和结果时调用此函数。对每一个新组，在开始之时调用它，但是它也可以被调用来为一个没有匹配行在其中的查询重置值。如下说明 xxx_clear()：

char *xxx_clear(UDF_INIT *initid, char *is_null, char *error);

在调用 xxx_clear() 之前 is_null 被设置指向 CHAR(0) 。

如果发生错误，你可以存储一个值在 error 参量指向的变量中。error 指向一单字节变量，而不是一个字符串缓冲区。

xxx_clear() 是 MySQL 5.1 必须的。

xxx_add()

为同组除了第一行之外，所有的行调用这个函数。你应该用它在 UDF_ARGS 参量中向内部总和变量加值。.

char *xxx_add(UDF_INIT *initid, UDF_ARGS *args,
              char *is_null, char *error);

unsigned int arg_count

参量个数。如果你需要你的函数带着某个数目的参量被调用，在初始化函数检查这个值，例如：

if (args->arg_count != 2)
{
    strcpy(message,"XXX() requires two arguments");
    return 1;
}

enum Item_result *arg_type

一个指针，对每个参量指向包含类型的一个数列。可能的类型值是 STRING_RESULT, INT_RESULT 和 REAL_RESULT。

要确信一个参量是给定类型的，并且如果不是的话就返回一个错误，请检查初始化函数中的 arg_type 数列。比如：

if (args->arg_type[0] != STRING_RESULT ||
    args->arg_type[1] != INT_RESULT)
{
    strcpy(message,"XXX() requires a string and an integer");
    return 1;
}

要求你函数的参量是某一类型的另一方法是，使用初始化函数设置 arg_type 元素为你想要的类型。对所有对 xxx() 的调用而言，这会导致 MySQL 强制参量为这些类型。比如，要指定投两个参量强制成字符串和整数，在 xxx_init() 中分别：

args->arg_type[0] = STRING_RESULT;
args->arg_type[1] = INT_RESULT;

char **args

args->args 与初始化函数做有关传到你函数的参量的一般情况做通讯。对于常参量 i，args->args[i] 指向参量值。(看下面的说明了解如何妥善地访问这个值)。对非－常参量，args->args[i] 为 0。一个常参量为仅使用参量的表达式，如 3 或 4*7-2 或 SIN(3.14)。一个非常 参量是一个行与行不同的表达式，如，列名或带非－常参量调用的函数。

对主函数的每次调用，args->args 包含为每个当前处理的行传递的实际参量。

如下使用参量 i 的函数：

unsigned long *lengths

对初始化函数，lengths 数列表示对每个参量的最大字符串长度。你不要改变它。对主函数的每次调用，lengths 包含了对当前处理行传递的任何字符串 参量的实际长度。对于 INT_RESULT 或 REAL_RESULT 类型的参量，lengths 仍包含参量的最大长度 (对初始化函数)。

metaphon() 返回字符串参量的一个变音位 (metaphon) 字符串，这有点象一个探测法 (soundex) 字符串，但是它英语更协调。

myfunc_double() 返回在其参量中所有字符的 ASCII 值的和，除以其 参量长度之和。

myfunc_int() 返回其参量长度之和。

sequence([const int]) 返回一个序列，从给定数开始，若没有给定数则从 1 开始。

lookup() 返回对应主机名的 IP 数。

reverse_lookup() 返回对应一个 IP 数的主机名。函数可以带'xxx.xxx.xxx.xxx'形式的一个单字符串 参量调用，要么带 4 个数字调用。