mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-10-06 16:40:48 +00:00
27 lines
1.2 KiB
Markdown
27 lines
1.2 KiB
Markdown
## ClickHouse performance tests
|
|
|
|
This directory contains `.xml`-files with performance tests for `clickhouse-performance-test` tool.
|
|
|
|
### How to write performance test
|
|
|
|
First of all you should check existing tests don't cover your case. If there are no such tests than you should write your own.
|
|
|
|
You have to specify `preconditions`. It contains table names. Only `hits_100m_single`, `hits_10m_single`, `test.hits` are available in CI.
|
|
|
|
The most important part of test is `stop_conditions`. Also you should always specify `total_time_ms` metric. Endless tests will be ignored by CI.
|
|
|
|
You can use `substitions`, `create`, `fill` and `drop` queries to prepare test. You can find examples in this folder.
|
|
|
|
Take into account, that these tests will run in CI which consists of 56-cores and 512 RAM machines. Queries will be executed much faster than on local laptop.
|
|
|
|
If your test continued more than 10 minutes, please, add tag `long` to have an opportunity to run all tests and skip long ones.
|
|
|
|
### How to run performance test
|
|
|
|
You have to run clickhouse-server and after you can start testing:
|
|
|
|
```
|
|
$ clickhouse-performance-test --input-file my_lovely_test1.xml --input-file my_lovely_test2.xml
|
|
$ clickhouse-performance-test --input-file /my_lovely_test_dir/
|
|
```
|