TcaplusDB Benchmark工具(C++)使用说明
1. 使用场景
TcaplusDB C++ Benchmark工具主要用于对TcaplusDB进行压力测试。
TcaplusDB C++ Benchmark工具支持基于固定数据集(CSV文件)的压力测试,也支持基于规则动态生成随机数据的压力测试。
TcaplusDB C++ Benchmark工具支持单种请求压力测试和多种请求混合压力测试,多个请求混合测试时,可以配置各种请求的比例。当前工具支持的请求类型有:
TDR表
- TCAPLUS_CMD_REPLACE_REQ
- TCAPLUS_CMD_INSERT_REQ
- TCAPLUS_CMD_DELETE_REQ
- TCAPLUS_CMD_GET_REQ
- TCAPLUS_CMD_UPDATE_REQ
- TCAPLUS_CMD_GET_RECORD_COUNT_REQ
- TCAPLUS_CMD_INCREASE_REQ
- TCAPLUS_CMD_GET_BY_PART_KEY_REQ
- TCAPLUS_CMD_BATCH_GET_REQ
- TCAPLUS_CMD_LIST_ADDAFTER_REQ
- TCAPLUS_CMD_LIST_REPLACE_REQ
- TCAPLUS_CMD_LIST_DELETE_REQ
- TCAPLUS_CMD_LIST_GET_REQ
- TCAPLUS_CMD_LIST_GETALL_REQ
- TCAPLUS_CMD_LIST_DELETEALL_REQ
PB表
- TCAPLUS_CMD_PB_SET_REQ
- TCAPLUS_CMD_PB_ADD_REQ
- TCAPLUS_CMD_PB_DELETE_REQ
- TCAPLUS_CMD_PB_GET_REQ
- TCAPLUS_CMD_PB_GET_BY_PART_KEY_REQ
- TCAPLUS_CMD_PB_GET_RECORD_COUNT_REQ
- TCAPLUS_CMD_PB_FIELD_GET_REQ
- TCAPLUS_CMD_PB_FIELD_SET_REQ
- TCAPLUS_CMD_PB_FIELD_INCREASE_REQ
- TCAPLUS_CMD_PB_LIST_ADDAFTER_REQ
- TCAPLUS_CMD_PB_LIST_REPLACE_REQ
- TCAPLUS_CMD_PB_LIST_GET_REQ
- TCAPLUS_CMD_PB_LIST_GETALL_REQ
- TCAPLUS_CMD_PB_LIST_DELETE_REQ
- TCAPLUS_CMD_PB_LIST_DELETEALL_REQ
- TCAPLUS_CMD_PB_LIST_DELETE_BATCH_REQ
- TCAPLUS_CMD_PB_BATCH_GET_REQ
2. 使用限制
TcaplusDB C++ Benchmark工具依赖TcaplusDB C++ TDR SDK和TcaplusDB C++ PB SDK进行数据读写。
3. 使用方法
3.1. 准备工作
下载Benchmark工具,参见Benchmark工具下载。
3.2. 基本测试方法(以Linux环境为例)
创建测试目录(本文以/data/目录为例)。
将Benchmark工具发布包中的tcaplus-benchmark目录复制到/data/目录下。
在TcaplusDB OMS页面上添加测试表,表定义参见/data/TcaplusBenchMark/workload/tdr/generic/table_test.xml。
修改/data/TcaplusBenchMark/workload/tdr/generic/workload.yml文件内容,主要修改点有:
4.1. 修改database相关配置,设置dir_servers,app_id,app_password和zone_id 。
4.2. 修改每个records参数值,将文件路径修改为:/data/TcaplusBenchMark/workload/tdr/generic/test_table_rule.yml。
- 开始测试,执行命令:
./TcaplusBenchMarkForCppApi -p database.app_id=2 -p database.zone_id=3 -p database.app_password='xxxxxxxx' -p database.dir_servers='tcp://x.x.x.x:9999' -w /data/benchMark/workload/tdr/list/workload.yml
3.3. 自定义测试方法
用户除了可以根据TcaplusDB C++ Benchmark工具发布包中提供样例表和测试任务配置文件进行基本的性能测试外,也可以编辑自己的测试任务配置文件,进行自定义的测试。测试任务配置文件设置方法参考发布包中的TcaplusBenchMark/workload/tdr/generic/workload.yml文件。