---
title: "mysqltest 使用说明 - OceanBase 数据库 V4.1.0 | OceanBase 文档中心"
description: mysqltest 使用说明 本文介绍如何在 OceanBase 数据库使用 mysqltest 进行 case 测试。 前提条件 使用 OBD（OceanBase Deploy） 启动一个集群。详细操作步骤，请参考 使用 OBD 快速启动 OceanBase 数据库 名词解释 case：执行 mysqltest 的…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.1.0

# mysqltest 使用说明

更新时间：2024-04-19 09:31:01

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.1.0/zh-CN/700.reference/700.ccomponents-and-tools/400.stress-test-tools/100.mysqltest/100.install-of-mysqltest.md)  

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

## 前提条件

使用 OBD（OceanBase Deploy） 启动一个集群。详细操作步骤，请参考 [使用 OBD 快速启动 OceanBase 数据库](https://github.com/oceanbase/obdeploy#%E5%BF%AB%E9%80%9F%E5%90%AF%E5%8A%A8-oceanbase-%E6%95%B0%E6%8D%AE%E5%BA%93)

## 名词解释

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

## mysqltest 使用

### 全量测试

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

```bash
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 执行测试，命令如下：

```bash
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` 进行测试，命令如下：

```bash
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 第一次执行失败时会自动重部署集群进行重试。

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线