Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

read_in_* セッション設定

これらの設定は system.settings で確認でき、ソースコード から自動生成されています。

read_in_order_two_level_merge_threshold

UInt64
デフォルト値
100

主キーの順序でマルチスレッド読み取りを行う際に、事前マージ ステップを実行するために読み取る最小パーツ数。

read_in_order_use_buffering

Bool
デフォルト値
1
バージョン履歴
バージョンデフォルト値コメント
24.71主キー順に読み取る際、マージ前にバッファリングを使用する

主キー順に読み取る際、マージ前にバッファリングを使用します。これによりクエリ実行の並列度が向上し

read_in_order_use_virtual_row

Bool
デフォルト値
1
バージョン履歴
バージョンデフォルト値コメント
26.81仮想行の最適化をデフォルトで有効にします。多数のパーツにまたがって主キー順に読み取る際、スパースインデックスの主キー値を使用して `MergingSortedTransform` がソースの優先順位を付け直します。これにより、クエリに関係のないパーツの読み取りを回避するとともに、読み取りの並列性を維持するために最大 `max_threads` 個のパーツに制限された先読みウィンドウを使用します。これによりピークメモリ使用量が大幅に削減されます(https://github.com/ClickHouse/ClickHouse/issues/52624 を参照)。
24.110主キーまたはその単調関数の順に読み取る際に仮想行を使用します。複数のパーツを検索する場合、関連するパーツにのみアクセスするため有用です。

主キーまたはその単調関数の順に読み取る際に仮想行を使用します。複数のパーツを検索する場合、実際に結果に寄与できるパーツのみが読み取られ、読み取りの並列性を維持するために最大 max_threads 個のパーツに制限された先読みウィンドウも使用されます。

read_in_order_use_virtual_row_per_block

Bool
デフォルト値
0
バージョン履歴
バージョンデフォルト値コメント
26.40read-in-order 中の各ブロックの読み取り後に(各パーツの先頭時だけでなく)仮想行 を出力し、MergingSortedTransform がより頻繁にソースの優先順位を付け直せるようにします。

read_in_order_use_virtual_row とあわせて有効にすると、各ブロックの読み取り後に 仮想行 を出力します (各パーツの先頭時のみではありません) 。 これにより、MergingSortedTransform がより頻繁にソースの優先順位を付け直せるようになり、下流のフィルタで多くの行が破棄され、データがパーツ間で不均一に分散している場合に有用です。 なお、これを有効にすると、読み取り時の read_in_order_use_buffering の最適化と事前マージ (read_in_order_two_level_merge_threshold) は無効になります。

Navigation