max_streams_for_files_processing_in_cluster_functions
max_streams_for_merge_tree_reading
max_streams_for_union_step
UNION ステップで同時にアクティブになるデータストリーム数を制限します (UNION DISTINCT は UNION ALL ステップの後に DISTINCT ステップを適用して実装されているため、UNION ALL と UNION DISTINCT の両方に適用されます) 。UNION クエリに多数のサブクエリがある場合、それらはすべて同時に読み取りバッファを開くため、メモリ使用量はサブクエリ数に比例して増加します。この設定では Concat プロセッサを挿入してパイプラインを絞り込み、同時にアクティブなストリーム数がこの値を超えないようにすることで、ピークメモリを大幅に削減します。実際の制限値は、この値と max_threads * max_streams_for_union_step_to_max_threads_ratio の小さい方です (どちらか一方が 0 の場合は無視されます) 。両方が 0 の場合、絞り込みは適用されません。また、クエリプラン上、UNION の各出力ストリームを個別にソート済みの状態で維持する必要がある場合 (たとえば、read-in-order 最適化が UNION 全体に適用される場合) 、この制限は適用されません。その場合は順序の正しさが優先され、絞り込みはスキップされます。
max_streams_for_union_step_to_max_threads_ratio
max_threads を掛けた値によって、UNION ステップで同時にアクティブなストリーム数の上限が決まります (UNION ALL と UNION DISTINCT の両方に適用されます) 。実際の上限は、この計算値と max_streams_for_union_step のうち小さい方です (どちらか一方が 0 の場合は無視されます) 。たとえば、max_threads = 8 でこの比率を 1 に設定すると、同時にアクティブになるストリームは最大 8 個です。この比率ベースの上限を無効にするには、0 に設定します。max_streams_for_union_step と同様に、クエリプラン上、UNION の各出力ストリームをそれぞれソート済みの状態に保つ必要がある場合、この上限は適用されません。