mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-04 21:42:39 +00:00
155 lines
5.6 KiB
Markdown
155 lines
5.6 KiB
Markdown
---
|
||
toc_priority: 61
|
||
toc_title: "性能测试"
|
||
---
|
||
|
||
# 性能测试 {#clickhouse-benchmark}
|
||
|
||
连接到ClickHouse服务器并重复发送指定的查询。
|
||
|
||
语法:
|
||
|
||
``` bash
|
||
$ echo "single query" | clickhouse-benchmark [keys]
|
||
```
|
||
|
||
或
|
||
|
||
``` bash
|
||
$ clickhouse-benchmark [keys] <<< "single query"
|
||
```
|
||
|
||
如果要发送一组查询，请创建一个文本文件，并将每个查询的字符串放在此文件中。 例如:
|
||
|
||
``` sql
|
||
SELECT * FROM system.numbers LIMIT 10000000
|
||
SELECT 1
|
||
```
|
||
|
||
然后将此文件传递给标准输入 `clickhouse-benchmark`.
|
||
|
||
``` bash
|
||
clickhouse-benchmark [keys] < queries_file
|
||
```
|
||
|
||
## keys参数 {#clickhouse-benchmark-keys}
|
||
|
||
- `-c N`, `--concurrency=N` — Number of queries that `clickhouse-benchmark` 同时发送。 默认值：1。
|
||
- `-d N`, `--delay=N` — Interval in seconds between intermediate reports (set 0 to disable reports). Default value: 1.
|
||
- `-h WORD`, `--host=WORD` — Server host. Default value: `localhost`. 为 [比较模式](#clickhouse-benchmark-comparison-mode) 您可以使用多个 `-h` 参数
|
||
- `-p N`, `--port=N` — Server port. Default value: 9000. For the [比较模式](#clickhouse-benchmark-comparison-mode) 您可以使用多个 `-p` 钥匙
|
||
- `-i N`, `--iterations=N` — 查询的总次数. Default value: 0.
|
||
- `-r`, `--randomize` — 有多个查询时，以随机顺序执行.
|
||
- `-s`, `--secure` — 使用TLS安全连接.
|
||
- `-t N`, `--timelimit=N` — Time limit in seconds. `clickhouse-benchmark` 达到指定的时间限制时停止发送查询。 默认值：0（禁用时间限制）。
|
||
- `--confidence=N` — Level of confidence for T-test. Possible values: 0 (80%), 1 (90%), 2 (95%), 3 (98%), 4 (99%), 5 (99.5%). Default value: 5. In the [比较模式](#clickhouse-benchmark-comparison-mode) `clickhouse-benchmark` 执行 [独立双样本学生的t测试](https://en.wikipedia.org/wiki/Student%27s_t-test#Independent_two-sample_t-test) 测试以确定两个分布是否与所选置信水平没有不同。
|
||
- `--cumulative` — Printing cumulative data instead of data per interval.
|
||
- `--database=DATABASE_NAME` — ClickHouse database name. Default value: `default`.
|
||
- `--json=FILEPATH` — JSON output. When the key is set, `clickhouse-benchmark` 将报告输出到指定的JSON文件。
|
||
- `--user=USERNAME` — ClickHouse user name. Default value: `default`.
|
||
- `--password=PSWD` — ClickHouse user password. Default value: empty string.
|
||
- `--stacktrace` — Stack traces output. When the key is set, `clickhouse-bencmark` 输出异常的堆栈跟踪。
|
||
- `--stage=WORD` — 查询请求的服务端处理状态. 在特定阶段Clickhouse会停止查询处理，并返回结果给`clickhouse-benchmark`。 可能的值: `complete`, `fetch_columns`, `with_mergeable_state`. 默认值: `complete`.
|
||
- `--help` — Shows the help message.
|
||
|
||
如果你想在查询时应用上述的部分参数 [设置](../../operations/settings/index.md) ，请将它们作为键传递 `--<session setting name>= SETTING_VALUE`. 例如, `--max_memory_usage=1048576`.
|
||
|
||
## 输出 {#clickhouse-benchmark-output}
|
||
|
||
默认情况下, `clickhouse-benchmark` 按照 `--delay` 参数间隔输出结果。
|
||
|
||
报告示例:
|
||
|
||
``` text
|
||
Queries executed: 10.
|
||
|
||
localhost:9000, queries 10, QPS: 6.772, RPS: 67904487.440, MiB/s: 518.070, result RPS: 67721584.984, result MiB/s: 516.675.
|
||
|
||
0.000% 0.145 sec.
|
||
10.000% 0.146 sec.
|
||
20.000% 0.146 sec.
|
||
30.000% 0.146 sec.
|
||
40.000% 0.147 sec.
|
||
50.000% 0.148 sec.
|
||
60.000% 0.148 sec.
|
||
70.000% 0.148 sec.
|
||
80.000% 0.149 sec.
|
||
90.000% 0.150 sec.
|
||
95.000% 0.150 sec.
|
||
99.000% 0.150 sec.
|
||
99.900% 0.150 sec.
|
||
99.990% 0.150 sec.
|
||
```
|
||
|
||
在结果报告中，您可以找到:
|
||
|
||
- 查询数量：参见`Queries executed:`字段。
|
||
|
||
- 状态码（按顺序给出）:
|
||
|
||
- ClickHouse服务器的连接信息。
|
||
- 已处理的查询数。
|
||
- QPS：服务端每秒处理的查询数量
|
||
- RPS：服务器每秒读取多少行
|
||
- MiB/s：服务器每秒读取多少字节的数据
|
||
- 结果RPS：服务端每秒生成多少行的结果集数据
|
||
- 结果MiB/s.服务端每秒生成多少字节的结果集数据
|
||
|
||
- 查询执行时间的百分比。
|
||
|
||
## 对比模式 {#clickhouse-benchmark-comparison-mode}
|
||
|
||
`clickhouse-benchmark` 可以比较两个正在运行的ClickHouse服务器的性能。
|
||
|
||
要使用对比模式，分别为每个服务器配置各自的`--host`, `--port`参数。`clickhouse-benchmark` 会根据设置的参数建立到各个Server的连接并发送请求。每个查询请求会随机发送到某个服务器。输出结果会按服务器分组输出
|
||
|
||
## 示例 {#clickhouse-benchmark-example}
|
||
|
||
``` bash
|
||
$ echo "SELECT * FROM system.numbers LIMIT 10000000 OFFSET 10000000" | clickhouse-benchmark -i 10
|
||
```
|
||
|
||
``` text
|
||
Loaded 1 queries.
|
||
|
||
Queries executed: 6.
|
||
|
||
localhost:9000, queries 6, QPS: 6.153, RPS: 123398340.957, MiB/s: 941.455, result RPS: 61532982.200, result MiB/s: 469.459.
|
||
|
||
0.000% 0.159 sec.
|
||
10.000% 0.159 sec.
|
||
20.000% 0.159 sec.
|
||
30.000% 0.160 sec.
|
||
40.000% 0.160 sec.
|
||
50.000% 0.162 sec.
|
||
60.000% 0.164 sec.
|
||
70.000% 0.165 sec.
|
||
80.000% 0.166 sec.
|
||
90.000% 0.166 sec.
|
||
95.000% 0.167 sec.
|
||
99.000% 0.167 sec.
|
||
99.900% 0.167 sec.
|
||
99.990% 0.167 sec.
|
||
|
||
|
||
|
||
Queries executed: 10.
|
||
|
||
localhost:9000, queries 10, QPS: 6.082, RPS: 121959604.568, MiB/s: 930.478, result RPS: 60815551.642, result MiB/s: 463.986.
|
||
|
||
0.000% 0.159 sec.
|
||
10.000% 0.159 sec.
|
||
20.000% 0.160 sec.
|
||
30.000% 0.163 sec.
|
||
40.000% 0.164 sec.
|
||
50.000% 0.165 sec.
|
||
60.000% 0.166 sec.
|
||
70.000% 0.166 sec.
|
||
80.000% 0.167 sec.
|
||
90.000% 0.167 sec.
|
||
95.000% 0.170 sec.
|
||
99.000% 0.172 sec.
|
||
99.900% 0.172 sec.
|
||
99.990% 0.172 sec.
|
||
```
|