mysql的测试工具MTR

1****、概述

在我们給MySQL打了patch后,不仅需要测试新增的功能,同时更重要的问题是,需要对原有的功能作回归――若新增的patch导致原有其他功能产生bug,就得不偿失。

MySQL自动测试框架是一个以MySQL框架和内部引擎为测试对象的工具。主要执行脚本在发布路径的mysql-test目录下。自动测试框架的主要测试步骤,是通过执行一个case,将该case的输出结果,与标准的输出结果作diff。这里的“标准输出结果”指代在可信任的MySQL版本上的执行结果。

如果某个case的执行结果与标准输出结果不同,则说明正在执行的这个MySQL服务有问题,或许是框架,或许是引擎。 当然若干case执行正确并不能确保被测试的框架和引擎是没有问题的,除非能够证明执行的case已经覆盖了所有的分支(这太难了)。

这里说到的case,是指一系列的语句,包括SQL语句和一些必要的shell语句。在mysql-test/t/目录下,可以找到很多这样的case,他们的文件名以.test为后缀。接下来我们用一个简单的例子来说明用法。

2****、初体验

   再简单的例子也不如自己写的简单。因此我们通过自己作一个case,来体验一下这个框架的便捷。

a) 在mysql-test/t/目录下创建文件 mytest.test, 内容为

| 1 — source include/have_innodb.inc

2 use test;

3 create table t(c int) engine=InnoDB ;

4 insert into t values(1);

5 select c from t;

6 drop table t;

|

   从第二行开始是我们熟悉的SQL语句,创建一个InnoDB表,插入一行,执行一个查询,删除这个表。输出也是显而易见的。

b) 在mysql-test/r/目录下创建文件 mytest.result, 内容为

| 1 use test;

2 create table t(c int) engine=InnoDB ;

3 insert into t values(1);

4 select c from t;

5 c

6 1

7 drop table t;

|

c) 在mysql-test/ 目录下执行 ./mtr mytest

|

===================================================================

TEST RESULT TIME (ms)

————————————————————

worker[1] Using MTR_BUILD_THREAD 300, with reserved ports 13000..13009

worker[1] mysql-test-run: WARNING: running this script as root will cause some tests to be skipped

main.mytest [ skipped ] No innodb support

main.mytest ‘innodb_plugin’ [ pass ] 5

————————————————————

The servers were restarted 0 times

Spent 0.005 of 3 seconds executing testcases

Completed: All 1 tests were successful.

|

最后一句话说明,测试通过了。

说明:

  1.  mysql-test/mtr这个文件,是一个perl脚本。同目录下还有 mysql-test-run 和mysql-test-run.pl这两个文件,这三个文件一模一样。
    
  2.  每个case会启动一个mysql服务,默认端口为13000。如果这个case涉及到需要启动多个服务(比如主从),则端口从13000递增。
    
  3.  ./mtr的参数只需要指明测试case的前缀即可,如你看到的。当你执行./mtr testname会自动到t/目录下搜索 testname.test文件来执行。当然你也可以执行./mtr mytest.test, 效果相同。
    
  4.  mytest.test第一行是必须的,当你需要使用InnoDB引擎的时候。可以看到mtr能够解释source语法,等效于将目标文件的内容全部拷贝到当前位置。Mysql-test/include目录下有很多这样的文件,他们提供了类似函数的功能,以简化每个case的代码。注意souce前面的 –, 大多数的非SQL语句都要求加 –。
    
  5.  mytest.test最后一行是删除这个创建的表。因为每个case都要求不要受别的case影响,也不要影响别的case,因此自己在case中创建的表要删除。
    
  6.  mtr会将mytest.test的执行结果与r/mytest.result作diff。 若完全相同,则表示测试结果正常。注意到我们例子中的mytest.result. 其中不仅包括了这个case的输出,也包括了输入的所有内容。实际上有效输出只有5、6两行。如果希望输出文件中只有执行结果,可以在第一行后面加入 — disable_query_log。
    

3****、冲突结果及处理

          我们来测试一个错误的输入输出。就在上文的mytest.test中加入一行,如下:

| 1 — source include/have_innodb.inc

2 — disable_query_log

3 use test;

4 create table t(c int) engine=InnoDB ;

5 insert into t values(1);

6 select c from t;

7 drop table t;

|

   执行 ./mtr mytest,我们知道,他只会输出两行,分别为c和1.

执行结果

| 。。。。。。

@@ -1,7 +1,2 @@

-use test;

-create table t(c int) engine=InnoDB ;

-insert into t values(1);

-select c from t;

c

1

-drop table t;

mysqltest: Result length mismatch

。。。。。。

Completed: Failed 1/1 tests, 0.00% were successful.

|

最后一句话说明我们的这个case测试没有通过。我们知道mtr将执行结果与r/mytest.result文件作diff,这个结果的前面部分就是diff的结果。

   说明:
  1.  执行case失败有很多中可能,比如中间执行了某个非法的语句,这个例子中的失败,指代的是执行结果与预期结果不同。
    
  2.  当前的执行结果会保存在r/mytest.reject中
    
  3.  如果mytest.reject中的结果才是正确的结果(错入出现在mytest.result中),可以用mytest.reject将result覆盖掉,这样正确的标准测试case就完成了。可以直接使用 ./mtr mytest –record命令生成mytest.result.
    
  4.  注意mtr在作diff的时候是直接文本比较,因此如果你的case中出现了多次执行结果可能不同的情况(比如时间相关),这不是一个好的case。当然处理的办法是有的,请参加附录中关于 replace_column的描述。
    

** 4****、批量执行的一些命令**

实际上我们更常用到的是批量执行的命令。

  1.  ./mtr
    

就是这么简单。会执行所有的case。当然包括刚刚我们加入的mytest.这里说的”所有的case”,包括t/目录下所有以.test为后缀的文件。也包括 suits目录下的所有以.test为后缀的文件。

注意只要任何一个case执行失败(包括内部执行失败和与result校验失败)都会导致整个执行计划退出。因此–force很常用,加入这个参数后,mtr会忽略错误并继续执行下一个case直到所有的case执行结束。

  1.  ./mtr –suite=funcs_1
    

Suits目录下有多个目录,是一些测试的套餐。此命令单独执行 suits/funcs_1目录下的所有case。(其他目录不执行)

t/目录下的所有文件组成了默认的套餐main。 因此 ./mtr –suite=main则只执行t/*.test.

  1.  ./mtr  –do-test=events
    

执行所有以 events为前缀的case(搜索范围为t/和所有的suite)。

–do-test的参数支持正则表达式,上诉命令等效于./mtr –do-test=events.*

所以如果想测试所有的包括innodb的case,可以用 ./mtr –do-test=.innodb.

5****、结束了

好吧。上面说的一些太简单了,简单到入门都不够。需要详细了解的可以到官网看e文。以下的tips是看官网的一些笔记。看到一点记录一点的,不成章。

附录

| 1、目录下的mtr文件即为mysql-test-run的缩写,文件内容相同

2、Mtr会启动mysql,有些case下可能重启server,为了使用不同的参数启动

3、调用bin/mysqltest读case并发送給mysql-server

4、输入和输出分别放在不同的文件中,执行结果与输出文件内容作对比

5、输入文件都在t目录下,输出文件在r目录下。对应的输入输出文件仅后缀名不同,分别为 *.test 和 *.result

6、每个testfile是一个测试用例,多个测试用例之间可能有关联。 一个file中任何一个非预期的失败都会导致整个test停止(使用force参数则可继续执行)。

7、注意如果服务端输出了未过滤的warning或error,则会也会导致test退出。

8、t目录下的*.opt文件是指在这个测试中,mysql必须以opt文件的内容作为测试参数启动。 *.sh文件是在执行启动mysql-server之前必须提前执行的脚本。disabled.def中定义了不执行的testfile。

9、r目录下, 若一个执行输出结果和testname.result文件不同,会生成一个testname.reject文件。 该文件在下次执行成功之后被删除。

10、 include目录是一些头文件,这些文件在t/*.test文件中使用,用source 命令引入

11、 lib目录是一些库函数,被mtr脚本调用

12、 有些测试需要用到一些标准数据,存在std_data目录下。

13、 Suite目录也是一些测试用例,每个目录下包含一套,./mtr –suite=funcs_1执行suits/funcs_1目录下的所有case

14、 Mtr实际调用mysqltest作测试。 –result-file文件用于指定预定义的输出,用于与实际输出作对比。若同时指定了 –recored参数,则表示这个输出数据不是用来对比的,而是要求将这个输出结果写入到指定的这个文件中。

15、 Mtr所在的目录路径中不能有空格

16、 Mtr –force参数会跳过某个错误继续执行,以查看所有的错误。

17、 执行./mtr时另外启动了一个mysql server,默认端口13000

18、 指定执行某个具体case使用 ./mtr testname, 会自动使用t/testname.rest

19、 ./mtr –do-test=events 执行以events开头的所有case,包括events_grant.test 等

同理 –skip-test=events 将以events打头的所有case跳过。 这里支持正则表达是,如./mtr –do-test=.innodb.则会执行t/目录下所有包含innodb子串的case

20、 Mtr允许并行执行,端口会从13000开始使用。但需要特别指定不同的—vardir指定不同的日志目录。但并行执行的case可能导致写同一个testname.reject.

21、 使用–parallel=auto可以多线程执行case。

22、 Mtr对比结果使用简单的diff,因此自己编写的测试case不应该因为执行时间不同而导致结果不同。当然框架在执行diff之前,允许自定义处理规则对得到的result作处理,来应对一些变化。

23、 ./mtr –record test_name 会将输出结果存入文件 r/test_name.result

24、 自己在脚本中创建的库、表等信息,要删除,否则会出warnning

25、 Mtr默认使用的是mysql-test/var/my.cnf文件,需要替换该文件为自定义的配置文件

26、 若要使用innodb引擎,必须明确在testname.test文件头加

– source include/have_innodb.inc

27、 Test文件名由字母数字、下划线、中划线组成,但只能以字母数字打头

28、 — sleep 10 等待10s 注意前面的—和后面没有分号

29、 默认情况下, r/testname.result中会包含原语句和执行结果,若不想输出原语句,需要自t/restname.test文件头使用 — disable_query_log

30、 每个单独的case会重启服务并要求之前的数据是清空的。

31、 如果要测试出错语句,必须在testname.test文件中,在会出错的语句之前加入 –error 错误号。

比如重复创建表,语句如下

create table t(c int) engine=InnoDB ;

– error 1050

create table t(c int) engine=InnoDB ;

这样在testname.result中输出

create table t(c int) engine=InnoDB ;

ERROR 42S01: Table ‘t’ already exists

则能够正常通过

也可使用 ER_TABLE_EXISTS_TABLE (宏定义为1050)

也可使用 –error S42S01 (注意需要加前缀S),但S系列的可能一个错误号对应多种错误。

32、 –enable_info 在testname.test文件头增加这个命令,在结果中会多输出影响行数。

对应的关闭命令为 –disable_info

33、 enable_metadata 可以显示更多信息 disable_result_log不输出执行结果

34、 有些case的输出结果可能包含时间因素的影响,导致无法重复验证。–replace_column 可以解决部分情况。

–replace_column 1 XXXXX

Select a, b from t;

输出结果会是

XXXXX b.value

即将第一列固定替换为xxxxx。 注意,每个replace_column的影响范围仅局限于下一行的第一个select语句。

35、 mtr –mysqld=–skip-innodb –mysqld=–key_buffer_size=16384 用这种将参数启动传递給mysql server 。 每个选项必须有一个—mysqld打头,不能连在一起写,即使引号包含多个也不行。

36、 mysql-test-run.pl –combination=–skip-innodb –combination=–innodb,–innodb-file-per-table

这个命令是参数传给多个test case, 第一个参数传 skip-innodb, 第二个参数传 –innodb, innodb-file-per-table。 若所有启动参数中combination只出现一次,则无效。

37、 skip-core-file 强行控制server不要core

38、 如果需要在server启动前执行一些脚本,可以写在 t/testname.sh文件中,由mtr自动执行。

39、 等待语句

let $wait_condition= SELECT c = 3 FROM t;

–source include/wait_condition.inc

          Mtr会一直停在 source这行,每隔0.1s检测,直到上个语句中的$wait_condition返回值非0

40、 主从测试case

              a)        testname.test头部必须包含 souce include/master-slave.inc

              b)        主库的配置写在testname-master.opt, 从库的写在testname-slave.opt

              c)        对出从库的操作统一写在testname.test中,要对主库操作时,先执行connection master,之后的语句都是在主库上操作;同理connection slave;

从库上执行start slave之后要执行 –source include/wait_for_slave_to_start.inc 等待启动完成, 执行stop slave之后要执行–source include/wait_for_slave_to_stop.inc 等待停止完成。

41、 Case完成后,mtr会检测server的错误日志,如果里面包含Error或Warning,则会认为case fail。

             a)        如果要忽略整个验证server日志的过程,可以在文件头增加 –nowarnings

             b)        如果要指定忽略某些行,允许使用正则表达式,比如 call mtr.add_suppression(“The table ‘t[0-9]*’ is full”); 能够忽略 The table ‘t12′ is full 这样的warning

             c)        注意上面这个call语句也是输入语句的一部分,因此会输出到结果内容中,除非

–disable_query_log

call mtr.add_suppression(“The table ‘t[0-9]*’ is full”);

–enable_query_log

42、 在一个case中重启server

–exec echo “wait” > $MYSQL_TMP_DIR/mysqld.1.expect

–shutdown_server 10

–source include/wait_until_disconnected.inc

Do something while server is down

–enable_reconnect

–exec echo “restart” > $MYSQL_TMP_DIR/mysqld.1.expect

–source include/wait_until_connected_again.inc

43、 循环语句语法

let $1= 1000;

while ($1)

{

execute your statements here

dec $1;

}

44、 mysql_client_test是一个单独的case,里面包含了多个case, 但并不是写成脚本,而是直接调用,可以直接从源码中看到里面调用的各个语句。源码位置tests/mysql_client_test.c

45、 直接执行 ./mtr 会执行t/目录下的所有case,外加suits目录

46、 若在不同目录中有重名的case,则会依次全部执行

47、 Mysql-stress-test.pl用于压力测试,注意默认的my.cnf中的参数,比如innodb_buffer_pool_size只有128M

48、 Case中的语句是以分号结尾的。echo a; select 1 from t limit 1; echo b;是三个语句,在result文件中的对应输出是 a \n 1 \n b

49、 Testcase中支持的脚本语言函数
http://dev.mysql.com/doc/mysqltest/2.0/en/mysqltest-commands.html

没有列出的函数可以用 – exec +shell命令实现

50、 设置变量 let $a = xx, 前面可加 –

51、 若是数字,可使用 inc a, 前面可加 –

52、 可以赋值为sql返回值 let q = $PATH

|

你可能感兴趣的:(mysql的测试工具MTR)