Stress Test TiDB Using TiUP Bench Component
When you test the performance of a database, it is often required to stress test the database. To facilitate this, TiUP has integrated the bench component, which provides two workloads for stress testing: TPC-C and TPC-H. The commands and flags are as follows. For more information, see the TPC official website.
tiup bench
Benchmark database with different workloads
Usage:
tiup bench [command]
Available Commands:
help Help about any command
tpcc
tpch
Flags:
--count int Total execution count, 0 means infinite
-D, --db string Database name (default "test")
-d, --driver string Database driver: mysql
--dropdata Cleanup data before prepare
-h, --help help for /Users/joshua/.tiup/components/bench/v0.0.1/bench
-H, --host string Database host (default "127.0.0.1")
--ignore-error Ignore error when running workload
--interval duration Output interval time (default 10s)
--isolation int Isolation Level 0: Default, 1: ReadUncommitted,
2: ReadCommitted, 3: WriteCommitted, 4: RepeatableRead,
5: Snapshot, 6: Serializable, 7: Linerizable
--max-procs int runtime.GOMAXPROCS
-p, --password string Database password
-P, --port int Database port (default 4000)
--pprof string Address of pprof endpoint
--silence Don't print error when running workload
--summary Print summary TPM only, or also print current TPM when running workload
-T, --threads int Thread concurrency (default 16)
--time duration Total execution time (default 2562047h47m16.854775807s)
-U, --user string Database user (default "root")
The following sections describe how to run TPC-C and TPC-H tests using TiUP.
Run TPC-C test using TiUP
The TiUP bench component supports the following commands and flags to run the TPC-C test:
Available Commands:
check Check data consistency for the workload
cleanup Cleanup data for the workload
prepare Prepare data for the workload
run Run workload
Flags:
--check-all Run all consistency checks
-h, --help help for tpcc
--parts int Number to partition warehouses (default 1)
--warehouses int Number of warehouses (default 10)
Test procedures
Create 4 warehouses using 4 partitions via hash:
tiup bench tpcc --warehouses 4 --parts 4 prepare
Run the TPC-C test:
tiup bench tpcc --warehouses 4 run
Clean up data:
tiup bench tpcc --warehouses 4 cleanup
Check the consistency:
tiup bench tpcc --warehouses 4 check
Generate the CSV file:
tiup bench tpcc --warehouses 4 prepare --output-dir data --output-type=csv
Generate the CSV file for the specified table:
tiup bench tpcc --warehouses 4 prepare --output-dir data --output-type=csv --tables history,orders
Run TPC-H test using TiUP
The TiUP bench component supports the following commands and parameters to run the TPC-H test:
Available Commands:
cleanup Cleanup data for the workload
prepare Prepare data for the workload
run Run workload
Flags:
--check Check output data, only when the scale factor equals 1
-h, --help help for tpch
--queries string All queries (default "q1,q2,q3,q4,q5,q6,q7,q8,q9,q10,q11,q12,q13,q14,q15,q16,q17,q18,q19,q20,q21,q22")
--sf int scale factor
Test procedures
Prepare data:
tiup bench tpch --sf=1 prepare
Run the TPC-H test by executing one of the following commands:
If you check the result, run this command:
tiup bench tpch --sf=1 --check=true run
If you do not check the result, run this command:
tiup bench tpch --sf=1 run
Clean up data:
tiup bench tpch cleanup