mysqltest 使用说明

本文介绍如何在 OceanBase 数据库使用 mysqltest 进行 case 测试。

前提条件

使用 OBD（OceanBase Deploy） 启动一个集群。详细操作步骤，请参考 使用 OBD 快速启动 OceanBase 数据库

名词解释

case：执行 mysqltest 的最小单位，一个 case 至少包含一个 test 文件和一个 result 文件。 suite：一组 case 的集合，称为 suite。

mysqltest 使用

全量测试

执行 mysql_test/test_suite 下全部的测试，命令如下：

obd test mysqltest <deploy name> --all --auto-retry
# 如果执行 obd 命令时不处于当前目录请使用 --suite-dir 选项
# 一些 case 中包含是相当路径，不在当前目录执行可能会导致失败

• 参数 deploy name 为部署配置名称，可以理解为配置文件名称。

• 选项 --suite-dir 为 suite 所在目录，默认为 ./mysql_test/test_suite。

• 选项 --all 为执行 --suite-dir 下全部 suite。

• 选项 --auto-retry 开启后，当 case 第一次执行失败时会自动重部署集群进行重试。

单 suite 测试

对 mysql_test/test_suite 下指定 suite 执行测试，命令如下：

obd test mysqltest <deploy name> --suite <suite_name>  --auto-retry
# 如果执行 obd 命令时不处于当前目录请使用 --suite-dir 选项
# 一些 case 中包含是相当路径，不在当前目录执行可能会导致失败

• 参数 deploy name 为部署配置名称，可以理解为配置文件名称。

• 选项 --suite-dir 为 suite 所在目录，默认为 ./mysql_test/test_suite。

• 选项 --suite 为要执行 suite 的集合，多个 suite 之间使用英文逗号（,）间隔。

• 选项 --auto-retry 开启后，当 case 第一次执行失败时会自动重部署集群进行重试。

单 case 测试

对特定 case 进行测试，比如对 mysql_test/test_suite/alter/t/alter_log_archive_option.test 进行测试，命令如下：

obd test mysqltest <deploy name> --test-dir ./mysql_test/test_suite/alter/t --result-dir ./mysql_test/test_suite/alter/r --test-set alter_log_archive_option --auto-retry
# 如果执行 obd 命令时不处于当前目录请调整 --test-dir 和 --result-dir
# 一些 case 中包含是相当路径，不在当前目录执行可能会导致失败

• 参数 deploy name 为部署配置名称，可以理解为配置文件名称。

• 选项 --test-dir 为 test 文件 所在目录，默认为 ./t。

• 选项 --result-dir 为 result 文件 所在目录，默认为 ./r。

• 选项 --test-set 为要执行 case 的集合，多个case之间使用英文逗号（,）间隔。

• 选项 --auto-retry 开启后，当 case 第一次执行失败时会自动重部署集群进行重试。