clickhouse-benchmark
连接到 ClickHouse 服务器并重复发送指定的查询。
语法
或
或
如果要发送一组查询，请创建一个文本文件，并将每个查询放在此文件中的单独字符串上。例如：
然后将此文件传递给 clickhouse-benchmark 的标准输入：
选项
--query=QUERY— 要执行的查询。如果没有传递此参数，clickhouse-benchmark将从标准输入读取查询。-c N,--concurrency=N—clickhouse-benchmark同时发送的查询数量。默认值：1。-d N,--delay=N— 中间报告之间的间隔（要禁用报告，请设置为 0）。默认值：1。-h HOST,--host=HOST— 服务器主机。默认值：localhost。对于 比较模式，可以使用多个-h选项。-i N,--iterations=N— 查询的总数。默认值：0（无限重复）。-r,--randomize— 如果有多个输入查询，则按随机顺序执行查询。-s,--secure— 使用TLS连接。-t N,--timelimit=N— 限制时间（秒）。当达到指定的时间限制时，clickhouse-benchmark停止发送查询。默认值：0（禁用时间限制）。--port=N— 服务器端口。默认值：9000。对于 比较模式，可以使用多个--port选项。--confidence=N— T 检验的置信水平。可能的值：0（80%），1（90%），2（95%），3（98%），4（99%），5（99.5%）。默认值：5。在 比较模式 中，clickhouse-benchmark执行 独立两样本 Student's t-test 来确定在选定的置信水平下，两者分布是否不同。--cumulative— 打印累积数据而非每个间隔的数据。--database=DATABASE_NAME— ClickHouse 数据库名称。默认值：default。--user=USERNAME— ClickHouse 用户名。默认值：default。--password=PSWD— ClickHouse 用户密码。默认值：空字符串。--stacktrace— 输出堆栈跟踪。当设置此选项时，clickhouse-benchmark输出异常的堆栈跟踪。--stage=WORD— 服务器上的查询处理阶段。ClickHouse 在指定阶段停止查询处理并将答案返回给clickhouse-benchmark。可能的值：complete，fetch_columns，with_mergeable_state。默认值：complete。--reconnect=N- 控制重连行为。可能的值0（从不重连），1（每个查询重连），或 N（每 N 个查询后重连）。默认值：1。--help— 显示帮助信息。
如果要为查询应用一些 设置，将其作为键 --<session setting name>= SETTING_VALUE 传递。例如，--max_memory_usage=1048576。
输出
默认情况下，clickhouse-benchmark 在每个 --delay 间隔报告。
报告示例：
在报告中，您可以找到：
-
Queries executed:字段中的查询数量。 -
状态字符串包含（按顺序）：
- ClickHouse 服务器的端点。
- 已处理的查询数量。
- QPS：在
--delay参数指定的期间内，服务器每秒执行多少查询。 - RPS：在
--delay参数指定的期间内，服务器每秒读取多少行。 - MiB/s：在
--delay参数指定的期间内，服务器每秒读取多少迈比字节。 - result RPS：在
--delay参数指定的期间内，服务器每秒向查询结果放置多少行。 - result MiB/s：在
--delay参数指定的期间内，服务器每秒向查询结果放置多少迈比字节。
-
查询执行时间的百分位数。
比较模式
clickhouse-benchmark 可以比较两个运行中 ClickHouse 服务器的性能。
要使用比较模式，通过两个对的 --host，--port 选项指定两个服务器的端点。选项在参数列表中按位置匹配，第一个 --host 与第一个 --port 匹配，依此类推。clickhouse-benchmark 建立连接到两个服务器，然后发送查询。每个查询发送到随机选择的服务器。结果以表格形式显示。
