mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-05 05:52:05 +00:00
5.7 KiB
5.7 KiB
slug | sidebar_position | sidebar_label |
---|---|---|
/zh/operations/utilities/clickhouse-benchmark | 61 | 性能测试 |
性能测试
连接到ClickHouse服务器并重复发送指定的查询。
语法:
$ echo "single query" | clickhouse-benchmark [keys]
或
$ clickhouse-benchmark [keys] <<< "single query"
如果要发送一组查询,请创建一个文本文件,并将每个查询的字符串放在此文件中。 例如:
SELECT * FROM system.numbers LIMIT 10000000
SELECT 1
然后将此文件传递给标准输入 clickhouse-benchmark
.
clickhouse-benchmark [keys] < queries_file
keys参数
-c N
,--concurrency=N
— Number of queries thatclickhouse-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
. 为 比较模式 您可以使用多个-h
参数-p N
,--port=N
— Server port. Default value: 9000. For the 比较模式 您可以使用多个-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
执行 独立双样本学生的t测试 测试以确定两个分布是否与所选置信水平没有不同。--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.
如果你想在查询时应用上述的部分参数 设置 ,请将它们作为键传递 --<session setting name>= SETTING_VALUE
. 例如, --max_memory_usage=1048576
.
输出
默认情况下, clickhouse-benchmark
按照 --delay
参数间隔输出结果。
报告示例:
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
可以比较两个正在运行的ClickHouse服务器的性能。
要使用对比模式,分别为每个服务器配置各自的--host
, --port
参数。clickhouse-benchmark
会根据设置的参数建立到各个Server的连接并发送请求。每个查询请求会随机发送到某个服务器。输出结果会按服务器分组输出
示例
$ echo "SELECT * FROM system.numbers LIMIT 10000000 OFFSET 10000000" | clickhouse-benchmark -i 10
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.