mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-16 19:32:07 +00:00
7.1 KiB
7.1 KiB
| slug | sidebar_position | sidebar_label |
|---|---|---|
| /ja/operations/utilities/clickhouse-benchmark | 61 | clickhouse-benchmark |
clickhouse-benchmark
ClickHouseサーバーに接続し、指定されたクエリを繰り返し送信します。
構文
$ clickhouse-benchmark --query ["single query"] [keys]
または
$ 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;
キー
--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は指定された信頼レベルで独立二標本のスチューデントのt検定を実行して、2つの分布に違いがないかを判断します。--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。--help— ヘルプメッセージを表示します。
クエリにいくつかの設定を適用したい場合は、--<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:
--delay引数で指定された期間中、サーバーが1秒あたりに実行したクエリ数。 - RPS:
--delay引数で指定された期間中、サーバーが1秒あたりに読み取った行数。 - MiB/s:
--delay引数で指定された期間中、サーバーが1秒あたりに読み取ったMebibytes数。 - result RPS:
--delay引数で指定された期間中、サーバーがクエリの結果に1秒あたりに配置した行数。 - result MiB/s:
--delay引数で指定された期間中、サーバーがクエリの結果に1秒あたりに配置したMebibytes数。
-
クエリ実行時間のパーセンタイル。
比較モード
clickhouse-benchmarkは2つの稼働中のClickHouseサーバーのパフォーマンスを比較できます。
比較モードを使用するには、両方のサーバーのエンドポイントを--host、--portキーの2組で指定します。キーは引数リスト内での位置によって組み合わされます。最初の--hostは最初の--portと組み合わされる、というように。clickhouse-benchmarkは両方のサーバーに接続を確立し、クエリを送信します。各クエリはランダムに選ばれたサーバーに送信されます。結果は表として表示されます。
例
$ echo "SELECT * FROM system.numbers LIMIT 10000000 OFFSET 10000000" | clickhouse-benchmark --host=localhost --port=9001 --host=localhost --port=9000 -i 10
Loaded 1 queries.
Queries executed: 5.
localhost:9001, queries 2, QPS: 3.764, RPS: 75446929.370, MiB/s: 575.614, result RPS: 37639659.982, result MiB/s: 287.168.
localhost:9000, queries 3, QPS: 3.815, RPS: 76466659.385, MiB/s: 583.394, result RPS: 38148392.297, result MiB/s: 291.049.
0.000% 0.258 sec. 0.250 sec.
10.000% 0.258 sec. 0.250 sec.
20.000% 0.258 sec. 0.250 sec.
30.000% 0.258 sec. 0.267 sec.
40.000% 0.258 sec. 0.267 sec.
50.000% 0.273 sec. 0.267 sec.
60.000% 0.273 sec. 0.267 sec.
70.000% 0.273 sec. 0.267 sec.
80.000% 0.273 sec. 0.269 sec.
90.000% 0.273 sec. 0.269 sec.
95.000% 0.273 sec. 0.269 sec.
99.000% 0.273 sec. 0.269 sec.
99.900% 0.273 sec. 0.269 sec.
99.990% 0.273 sec. 0.269 sec.
No difference proven at 99.5% confidence