1. mysqltest是mysql自带的测试引擎, 它实现了一种小语言,用来描述测试过程,并将测试结果与预期对比。

 小语言按照语法大致分为三类:mysql command,sql,comment。sql和comment很容易理解,前者是mysql支持的sql,

mysqltest解释的是以test为后缀名的文本文件

mysqltest case的语法比较简单,分三类:
1. command

command用来控制运行时的行为,后面重点介绍。
一般有两种写法:
command; # 这是后面带;的
--command # 前面带--,不需要;
另外,while和if要稍微特殊些。

2. sql
  就是普通的sql语句,CASE里面大部分都是sql,以分号结束。
3. comment
  就是注释,用#开头

mysqltest提供了几十个command,下面只介绍我们常用的。

1. --error
有些CASE就是要验证sql失败的情况,在sql语句前面加上—error 错误码就可以了。--error后面可以跟两种值,一种是error no,另外一种是sqlstate,如果是后者需要加上S做前缀。
比如:

--error 65535 
create table t1(pk createtime primary key, a int);



--error SHY000 
select a from t1 union select * from t2;


2. disable_abort_on_error / enable_abort_on_error
默认情况下(enable)sql执行失败后mysqltest就退出了,后面的内容就不会执行,也不会生成reject文件,显示执行disable命令可以在sql失败后继续执行后面的内容,并生成reject文件。
3. disable_query_log / enable_query_log
默认情况下(enable)所有的sql语句都会在result文件中记录,在一些情况下(比如使用了循环可能query特别多)不想打开显示调用disable既可。
其他形如enable_XX/disable_XX的命令还有很多,用法都类似。
4. enable_parsing/disable_parsing
用来注释多行,跟comment类似。
5. connect/disconnect与conncetion
测试session的时候可能会用到这两个命令,前者是建立或断开一个连接。后者是表示使用哪个连接执行sql语句,可以在多个connection之间切换
比如:

connect (conn3,127.0.0.1,root,,test,25042); 
connection conn3; 
create table t1(a int primary key); 
drop table t1; 
disconnect conn3;


6. system/exec
执行shell命令
7. perl [terminator]
嵌入perl code,直到terminator位置,比如:

perl END_OF_FILE; 
print "This is another test\n"; 
END_OF_FILE


8. vertical_results/horizontal_results
功能跟sql语句的’\G’类似
9. exit
退出,其后的内容不会执行
10. let $var_name = value
变量赋值,整数、字符串都可以
11. inc $var_name/dec $var_name
整数加1/减1,是mysqltest唯一支持的运算。
12. eval
执行sql语句,支持变量的传递,比如:

eval insert into t1(i,c1,c256,dt,d) values(0,'1','$i','2012-10-10 12:00:00','2012-10-10');


13. query
mysqltest解释每一行的时候会先判断是sql语句还是command,如果是query指定的,都认为是sql语句,这是避免comand名字与sql有冲突,一般也不会。
14. send/reap/eval_send
发送query后不用等待结果立即返回,在reap之前不能使用同一个connection发送sql语句。
eval_send支持变量传递。
15. echo
打印
16. query_get_value(query, col_name, row_num)
获得query返回的结果中某行某列的值
17. source
多个case可能共用一块代码,这块代码可以单独放到一个文件,通过source导入。
18. require
将下一个query的结果与require指定的结果文件做对比,如果匹配失败就报“this test is not supported”的错误。这个一般用于判断test是否可以在某版本中使用。
19. result
显式指定保存运行结果的文件路径
20. sleep/real_sleep
休眠.
21. replace_column
对查询结果的某些列的值进行替换,有些结果是随着执行时间变化的,比如createtime或modifytime类型,为了比较可以用这个命令将这个值替换成某常量。比如:

--replace_column 2 searched 
select pk,b from t1;


22.

if(exptr) 
{ 
}


当Exptr非0,就执行大括号部分。注意,mysqltest没有提供else if或else。低版本的mysqltest不支持exptr为比较表达式。
比如:

if($value_now == $value_orig) 
{ 
 --echo succeed 
} 
23. while(exptr) 
{ 
}


执行大括号部分,知道exptr为0. 低版本的mysqltest不支持exptr为比较表达式。没有break类似的命令,可以使用end试试。
比如:

while($i < 10000) 
{ 
 eval insert into t1(i,c1,c256,dt,d) values(0,'1','$i','2012-10-10 12:00:00','2012-10-10'); 
 inc $i; 
}


其他的命令还有:
1. ping,shutdown,save_master_pos,sync_slave_with_master , sync_with_master 等等,类似于mysqladmin/mysql(我们暂不支持)的功能。
2. start_timer等计时命令
3. append_file, mv, remove_file,chmod,write_file等文件操作的命令

详细请参考:http://dev.mysql.com/doc/mysqltest/2.0/en/mysqltest-commands.html

语法代码实列如下:

--echo # 修改session的值,使用脚本来测别名的更改.

connect (conn1,$OBMYSQL_MS0,root@sys,,oceanbase,$OBMYSQL_PORT);
connect (conn2,$OBMYSQL_MS0,admin@oracle,admin,test,$OBMYSQL_PORT);let $current_num=1;
let $number=575;
while ($current_num <= $number)
{
connection conn1;
let $tz_name = query_get_value(select name from oceanbase.__all_time_zone_name order by name, name, $current_num);
connection conn2;
eval alter session set time_zone='$tz_name';
eval select sessiontimezone from dual;
inc $current_num;
}