risingwave_meta/hummock/compaction/picker/
base_level_compaction_picker.rs

1// Copyright 2025 RisingWave Labs
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7//     http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15use std::cell::RefCell;
16use std::sync::Arc;
17
18use itertools::Itertools;
19use risingwave_common::config::default::compaction_config;
20use risingwave_hummock_sdk::level::{InputLevel, Level, Levels, OverlappingLevel};
21use risingwave_pb::hummock::{CompactionConfig, LevelType};
22
23use super::min_overlap_compaction_picker::NonOverlapSubLevelPicker;
24use super::{
25    CompactionInput, CompactionPicker, CompactionTaskValidator, LocalPickerStatistic,
26    ValidationRuleType,
27};
28use crate::hummock::compaction::picker::TrivialMovePicker;
29use crate::hummock::compaction::{CompactionDeveloperConfig, create_overlap_strategy};
30use crate::hummock::level_handler::LevelHandler;
31
32std::thread_local! {
33    static LOG_COUNTER: RefCell<usize> = const { RefCell::new(0) };
34}
35
36pub struct LevelCompactionPicker {
37    target_level: usize,
38    config: Arc<CompactionConfig>,
39    compaction_task_validator: Arc<CompactionTaskValidator>,
40    developer_config: Arc<CompactionDeveloperConfig>,
41}
42
43impl CompactionPicker for LevelCompactionPicker {
44    fn pick_compaction(
45        &mut self,
46        levels: &Levels,
47        level_handlers: &[LevelHandler],
48        stats: &mut LocalPickerStatistic,
49    ) -> Option<CompactionInput> {
50        let l0 = &levels.l0;
51        if l0.sub_levels.is_empty() {
52            return None;
53        }
54        if l0.sub_levels[0].level_type != LevelType::Nonoverlapping
55            && l0.sub_levels[0].table_infos.len() > 1
56        {
57            stats.skip_by_overlapping += 1;
58            return None;
59        }
60
61        let is_l0_pending_compact =
62            level_handlers[0].is_level_all_pending_compact(&l0.sub_levels[0]);
63
64        if is_l0_pending_compact {
65            stats.skip_by_pending_files += 1;
66            return None;
67        }
68
69        if let Some(mut ret) = self.pick_base_trivial_move(
70            l0,
71            levels.get_level(self.target_level),
72            level_handlers,
73            stats,
74        ) {
75            ret.vnode_partition_count = self.config.split_weight_by_vnode;
76            return Some(ret);
77        }
78
79        debug_assert!(self.target_level == levels.get_level(self.target_level).level_idx as usize);
80        if let Some(ret) = self.pick_multi_level_to_base(
81            l0,
82            levels.get_level(self.target_level),
83            self.config.split_weight_by_vnode,
84            level_handlers,
85            stats,
86        ) {
87            return Some(ret);
88        }
89
90        None
91    }
92}
93
94impl LevelCompactionPicker {
95    #[cfg(test)]
96    pub fn new(
97        target_level: usize,
98        config: Arc<CompactionConfig>,
99        developer_config: Arc<CompactionDeveloperConfig>,
100    ) -> LevelCompactionPicker {
101        LevelCompactionPicker {
102            target_level,
103            compaction_task_validator: Arc::new(CompactionTaskValidator::new(config.clone())),
104            config,
105            developer_config,
106        }
107    }
108
109    pub fn new_with_validator(
110        target_level: usize,
111        config: Arc<CompactionConfig>,
112        compaction_task_validator: Arc<CompactionTaskValidator>,
113        developer_config: Arc<CompactionDeveloperConfig>,
114    ) -> LevelCompactionPicker {
115        LevelCompactionPicker {
116            target_level,
117            config,
118            compaction_task_validator,
119            developer_config,
120        }
121    }
122
123    fn pick_base_trivial_move(
124        &self,
125        l0: &OverlappingLevel,
126        target_level: &Level,
127        level_handlers: &[LevelHandler],
128        stats: &mut LocalPickerStatistic,
129    ) -> Option<CompactionInput> {
130        if !self.developer_config.enable_trivial_move {
131            return None;
132        }
133
134        let overlap_strategy = create_overlap_strategy(self.config.compaction_mode());
135        let trivial_move_picker = TrivialMovePicker::new(
136            0,
137            self.target_level,
138            overlap_strategy.clone(),
139            if self.compaction_task_validator.is_enable() {
140                // tips: Older versions of the compaction group will be upgraded without this configuration, we leave it with its default behaviour and enable it manually when needed.
141                self.config.sst_allowed_trivial_move_min_size.unwrap_or(0)
142            } else {
143                0
144            },
145            self.config
146                .sst_allowed_trivial_move_max_count
147                .unwrap_or(compaction_config::sst_allowed_trivial_move_max_count())
148                as usize,
149        );
150
151        trivial_move_picker.pick_trivial_move_task(
152            &l0.sub_levels[0].table_infos,
153            &target_level.table_infos,
154            level_handlers,
155            stats,
156        )
157    }
158
159    fn pick_multi_level_to_base(
160        &self,
161        l0: &OverlappingLevel,
162        target_level: &Level,
163        vnode_partition_count: u32,
164        level_handlers: &[LevelHandler],
165        stats: &mut LocalPickerStatistic,
166    ) -> Option<CompactionInput> {
167        let overlap_strategy = create_overlap_strategy(self.config.compaction_mode());
168        let min_compaction_bytes = self.config.sub_level_max_compaction_bytes;
169        let non_overlap_sub_level_picker = NonOverlapSubLevelPicker::new(
170            min_compaction_bytes,
171            // divide by 2 because we need to select files of base level and it need use the other
172            // half quota.
173            std::cmp::max(
174                self.config.max_bytes_for_level_base,
175                self.config.max_compaction_bytes / 2,
176            ),
177            1,
178            // The maximum number of sub_level compact level per task
179            self.config.level0_max_compact_file_number,
180            overlap_strategy.clone(),
181            self.developer_config.enable_check_task_level_overlap,
182            self.config
183                .max_l0_compact_level_count
184                .unwrap_or(compaction_config::max_l0_compact_level_count()) as usize,
185            self.config
186                .enable_optimize_l0_interval_selection
187                .unwrap_or(compaction_config::enable_optimize_l0_interval_selection()),
188        );
189
190        let mut max_vnode_partition_idx = 0;
191        for (idx, level) in l0.sub_levels.iter().enumerate() {
192            if level.vnode_partition_count < vnode_partition_count {
193                break;
194            }
195            max_vnode_partition_idx = idx;
196        }
197
198        let l0_select_tables_vec = non_overlap_sub_level_picker.pick_l0_multi_non_overlap_level(
199            &l0.sub_levels[..=max_vnode_partition_idx],
200            &level_handlers[0],
201        );
202        if l0_select_tables_vec.is_empty() {
203            stats.skip_by_pending_files += 1;
204            return None;
205        }
206
207        let mut skip_by_pending = false;
208        let mut input_levels = vec![];
209
210        for input in l0_select_tables_vec {
211            let l0_select_tables = input
212                .sstable_infos
213                .iter()
214                .flat_map(|(_, select_tables)| select_tables.clone())
215                .collect_vec();
216
217            let target_level_ssts = overlap_strategy
218                .check_base_level_overlap(&l0_select_tables, &target_level.table_infos);
219
220            let mut target_level_size = 0;
221            let mut pending_compact = false;
222            for sst in &target_level_ssts {
223                if level_handlers[target_level.level_idx as usize].is_pending_compact(&sst.sst_id) {
224                    pending_compact = true;
225                    break;
226                }
227
228                target_level_size += sst.sst_size;
229            }
230
231            if pending_compact {
232                skip_by_pending = true;
233                continue;
234            }
235
236            input_levels.push((input, target_level_size, target_level_ssts));
237        }
238
239        if input_levels.is_empty() {
240            if skip_by_pending {
241                stats.skip_by_pending_files += 1;
242            }
243            return None;
244        }
245
246        for (input, target_file_size, target_level_files) in input_levels {
247            let mut select_level_inputs = input
248                .sstable_infos
249                .into_iter()
250                .map(|(_, table_infos)| InputLevel {
251                    level_idx: 0,
252                    level_type: LevelType::Nonoverlapping,
253                    table_infos,
254                })
255                .collect_vec();
256            select_level_inputs.reverse();
257            let target_file_count = target_level_files.len();
258            select_level_inputs.push(InputLevel {
259                level_idx: target_level.level_idx,
260                level_type: target_level.level_type,
261                table_infos: target_level_files,
262            });
263
264            let result = CompactionInput {
265                input_levels: select_level_inputs,
266                target_level: self.target_level,
267                select_input_size: input.total_file_size,
268                target_input_size: target_file_size,
269                total_file_count: (input.total_file_count + target_file_count) as u64,
270                vnode_partition_count,
271                ..Default::default()
272            };
273
274            if !self.compaction_task_validator.valid_compact_task(
275                &result,
276                ValidationRuleType::ToBase,
277                stats,
278            ) {
279                if l0.total_file_size > target_level.total_file_size * 8 {
280                    let log_counter = LOG_COUNTER.with_borrow_mut(|counter| {
281                        *counter += 1;
282                        *counter
283                    });
284
285                    // reduce log
286                    if log_counter % 100 == 0 {
287                        tracing::warn!(
288                            "skip task with level count: {}, file count: {}, select size: {}, target size: {}, target level size: {}",
289                            result.input_levels.len(),
290                            result.total_file_count,
291                            result.select_input_size,
292                            result.target_input_size,
293                            target_level.total_file_size,
294                        );
295                    }
296                }
297                continue;
298            }
299
300            return Some(result);
301        }
302        None
303    }
304}
305
306#[cfg(test)]
307pub mod tests {
308
309    use super::*;
310    use crate::hummock::compaction::compaction_config::CompactionConfigBuilder;
311    use crate::hummock::compaction::selector::tests::*;
312    use crate::hummock::compaction::{CompactionMode, TierCompactionPicker};
313
314    fn create_compaction_picker_for_test() -> LevelCompactionPicker {
315        let config = Arc::new(
316            CompactionConfigBuilder::new()
317                .level0_tier_compact_file_number(2)
318                .level0_sub_level_compact_level_count(1)
319                .build(),
320        );
321        LevelCompactionPicker::new(1, config, Arc::new(CompactionDeveloperConfig::default()))
322    }
323
324    #[test]
325    fn test_compact_l0_to_l1() {
326        let mut picker = create_compaction_picker_for_test();
327        let l0 = generate_level(
328            0,
329            vec![
330                generate_table(5, 1, 100, 200, 2),
331                generate_table(4, 1, 201, 300, 2),
332            ],
333        );
334        let mut levels = Levels {
335            l0: OverlappingLevel {
336                total_file_size: l0.total_file_size,
337                uncompressed_file_size: l0.total_file_size,
338                sub_levels: vec![l0],
339            },
340            levels: vec![generate_level(
341                1,
342                vec![
343                    generate_table(3, 1, 1, 100, 1),
344                    generate_table(2, 1, 101, 150, 1),
345                    generate_table(1, 1, 201, 210, 1),
346                ],
347            )],
348            ..Default::default()
349        };
350        let mut local_stats = LocalPickerStatistic::default();
351        let mut levels_handler = vec![LevelHandler::new(0), LevelHandler::new(1)];
352
353        let ret = picker
354            .pick_compaction(&levels, &levels_handler, &mut local_stats)
355            .unwrap();
356        assert_eq!(ret.input_levels[0].table_infos.len(), 1);
357        assert_eq!(ret.input_levels[0].table_infos[0].sst_id, 4);
358        assert_eq!(ret.input_levels[1].table_infos[0].sst_id, 1);
359
360        ret.add_pending_task(0, &mut levels_handler);
361        {
362            push_table_level0_nonoverlapping(&mut levels, generate_table(6, 1, 100, 200, 2));
363            push_table_level0_nonoverlapping(&mut levels, generate_table(7, 1, 301, 333, 4));
364            let ret2 = picker
365                .pick_compaction(&levels, &levels_handler, &mut local_stats)
366                .unwrap();
367
368            assert_eq!(ret2.input_levels[0].table_infos.len(), 1);
369            assert_eq!(ret2.input_levels[0].table_infos[0].sst_id, 6);
370            assert_eq!(ret2.input_levels[1].table_infos[0].sst_id, 5);
371        }
372
373        levels.l0.sub_levels[0]
374            .table_infos
375            .retain(|table| table.sst_id != 4);
376        levels.l0.total_file_size -= ret.input_levels[0].table_infos[0].file_size;
377
378        levels_handler[0].remove_task(0);
379        levels_handler[1].remove_task(0);
380
381        let ret = picker
382            .pick_compaction(&levels, &levels_handler, &mut local_stats)
383            .unwrap();
384        assert_eq!(ret.input_levels.len(), 3);
385        assert_eq!(ret.input_levels[0].table_infos[0].sst_id, 6);
386        assert_eq!(ret.input_levels[1].table_infos[0].sst_id, 5);
387        assert_eq!(ret.input_levels[2].table_infos.len(), 2);
388        assert_eq!(ret.input_levels[2].table_infos[0].sst_id, 3);
389        assert_eq!(ret.input_levels[2].table_infos[1].sst_id, 2);
390        ret.add_pending_task(1, &mut levels_handler);
391
392        let mut local_stats = LocalPickerStatistic::default();
393        // Cannot pick because no idle table in sub-level[0]. (And sub-level[0] is pending
394        // actually).
395        push_table_level0_overlapping(&mut levels, generate_table(8, 1, 199, 233, 3));
396        let ret = picker.pick_compaction(&levels, &levels_handler, &mut local_stats);
397        assert!(ret.is_none());
398
399        // Don't pick overlapping sub-level 8
400        levels_handler[0].remove_task(1);
401        levels_handler[1].remove_task(1);
402        let ret = picker
403            .pick_compaction(&levels, &levels_handler, &mut local_stats)
404            .unwrap();
405        assert_eq!(ret.input_levels.len(), 3);
406        assert_eq!(ret.input_levels[0].table_infos[0].sst_id, 6);
407        assert_eq!(ret.input_levels[1].table_infos[0].sst_id, 5);
408        assert_eq!(ret.input_levels[2].table_infos.len(), 2);
409    }
410
411    #[test]
412    fn test_selecting_key_range_overlap() {
413        // When picking L0->L1, all L1 files overlapped with selecting_key_range should be picked.
414        let config = Arc::new(
415            CompactionConfigBuilder::new()
416                .level0_tier_compact_file_number(2)
417                .compaction_mode(CompactionMode::Range as i32)
418                .level0_sub_level_compact_level_count(1)
419                .build(),
420        );
421
422        let config_enable_optimize_l0_interval_selection = Arc::new(
423            CompactionConfigBuilder::new()
424                .level0_tier_compact_file_number(2)
425                .compaction_mode(CompactionMode::Range as i32)
426                .level0_sub_level_compact_level_count(1)
427                .enable_optimize_l0_interval_selection(Some(true))
428                .build(),
429        );
430
431        let mut picker =
432            LevelCompactionPicker::new(1, config, Arc::new(CompactionDeveloperConfig::default()));
433
434        let mut picker_enable_optimize_l0_interval_selection = LevelCompactionPicker::new(
435            1,
436            config_enable_optimize_l0_interval_selection,
437            Arc::new(CompactionDeveloperConfig::default()),
438        );
439
440        let levels = vec![Level {
441            level_idx: 1,
442            level_type: LevelType::Nonoverlapping,
443            table_infos: vec![
444                generate_table(3, 1, 0, 50, 1),
445                generate_table(4, 1, 150, 180, 1),
446                generate_table(5, 1, 250, 300, 1),
447            ],
448            ..Default::default()
449        }];
450        let mut levels = Levels {
451            levels,
452            l0: OverlappingLevel {
453                sub_levels: vec![],
454                total_file_size: 0,
455                uncompressed_file_size: 0,
456            },
457            ..Default::default()
458        };
459        push_tables_level0_nonoverlapping(&mut levels, vec![generate_table(1, 1, 50, 140, 2)]);
460        push_tables_level0_nonoverlapping(
461            &mut levels,
462            vec![
463                generate_table(7, 1, 200, 250, 2),
464                generate_table(8, 1, 400, 500, 2),
465            ],
466        );
467
468        {
469            let mut levels_handler = vec![LevelHandler::new(0), LevelHandler::new(1)];
470
471            let mut local_stats = LocalPickerStatistic::default();
472            let ret = picker_enable_optimize_l0_interval_selection
473                .pick_compaction(&levels, &levels_handler, &mut local_stats)
474                .unwrap();
475
476            // pick
477            // l0 [sst_8]
478            assert_eq!(ret.input_levels.len(), 2);
479            assert_eq!(
480                ret.input_levels[0]
481                    .table_infos
482                    .iter()
483                    .map(|t| t.sst_id)
484                    .collect_vec(),
485                vec![8]
486            );
487            // trivial_move
488            assert!(ret.input_levels[1].table_infos.is_empty());
489
490            ret.add_pending_task(0, &mut levels_handler);
491
492            let ret = picker_enable_optimize_l0_interval_selection
493                .pick_compaction(&levels, &levels_handler, &mut local_stats)
494                .unwrap();
495
496            assert_eq!(ret.input_levels.len(), 2);
497            assert_eq!(
498                ret.input_levels[0]
499                    .table_infos
500                    .iter()
501                    .map(|t| t.sst_id)
502                    .collect_vec(),
503                vec![7]
504            );
505
506            assert_eq!(
507                ret.input_levels[1]
508                    .table_infos
509                    .iter()
510                    .map(|t| t.sst_id)
511                    .collect_vec(),
512                vec![5]
513            );
514        }
515
516        {
517            let levels_handler = vec![LevelHandler::new(0), LevelHandler::new(1)];
518
519            let mut local_stats = LocalPickerStatistic::default();
520            let ret = picker
521                .pick_compaction(&levels, &levels_handler, &mut local_stats)
522                .unwrap();
523
524            // pick
525            assert_eq!(ret.input_levels.len(), 2);
526            assert_eq!(
527                ret.input_levels[0]
528                    .table_infos
529                    .iter()
530                    .map(|t| t.sst_id)
531                    .collect_vec(),
532                vec![1]
533            );
534
535            assert_eq!(
536                ret.input_levels[1]
537                    .table_infos
538                    .iter()
539                    .map(|t| t.sst_id)
540                    .collect_vec(),
541                vec![3]
542            );
543        }
544    }
545
546    #[test]
547    fn test_l0_to_l1_compact_conflict() {
548        // When picking L0->L1, L0's selecting_key_range should not be overlapped with L0's
549        // compacting_key_range.
550        let mut picker = create_compaction_picker_for_test();
551        let levels = vec![Level {
552            level_idx: 1,
553            level_type: LevelType::Nonoverlapping,
554            table_infos: vec![],
555            total_file_size: 0,
556            sub_level_id: 0,
557            uncompressed_file_size: 0,
558            ..Default::default()
559        }];
560        let mut levels = Levels {
561            levels,
562            l0: OverlappingLevel {
563                sub_levels: vec![],
564                total_file_size: 0,
565                uncompressed_file_size: 0,
566            },
567            ..Default::default()
568        };
569        push_tables_level0_nonoverlapping(
570            &mut levels,
571            vec![
572                generate_table(1, 1, 100, 300, 2),
573                generate_table(2, 1, 350, 500, 2),
574            ],
575        );
576        let mut levels_handler = vec![LevelHandler::new(0), LevelHandler::new(1)];
577
578        let mut local_stats = LocalPickerStatistic::default();
579        let ret = picker
580            .pick_compaction(&levels, &levels_handler, &mut local_stats)
581            .unwrap();
582        // trivial_move
583        ret.add_pending_task(0, &mut levels_handler); // pending only for test
584        push_tables_level0_nonoverlapping(&mut levels, vec![generate_table(3, 1, 250, 300, 3)]);
585        let config: CompactionConfig = CompactionConfigBuilder::new()
586            .level0_tier_compact_file_number(2)
587            .max_compaction_bytes(1000)
588            .sub_level_max_compaction_bytes(150)
589            .max_bytes_for_level_multiplier(1)
590            .level0_sub_level_compact_level_count(3)
591            .build();
592        let mut picker = TierCompactionPicker::new(Arc::new(config));
593
594        let ret: Option<CompactionInput> =
595            picker.pick_compaction(&levels, &levels_handler, &mut local_stats);
596        assert!(ret.is_none());
597    }
598
599    #[test]
600    fn test_skip_compact_write_amplification_limit() {
601        let config: CompactionConfig = CompactionConfigBuilder::new()
602            .level0_tier_compact_file_number(2)
603            .max_compaction_bytes(1000)
604            .sub_level_max_compaction_bytes(150)
605            .max_bytes_for_level_multiplier(1)
606            .level0_sub_level_compact_level_count(2)
607            .build();
608        let mut picker = LevelCompactionPicker::new(
609            1,
610            Arc::new(config),
611            Arc::new(CompactionDeveloperConfig::default()),
612        );
613
614        let mut levels = Levels {
615            levels: vec![Level {
616                level_idx: 1,
617                level_type: LevelType::Nonoverlapping,
618                table_infos: vec![
619                    generate_table(1, 1, 100, 399, 2),
620                    generate_table(2, 1, 400, 699, 2),
621                    generate_table(3, 1, 700, 999, 2),
622                ],
623                total_file_size: 900,
624                sub_level_id: 0,
625                uncompressed_file_size: 900,
626                ..Default::default()
627            }],
628            l0: generate_l0_nonoverlapping_sublevels(vec![]),
629            ..Default::default()
630        };
631        push_tables_level0_nonoverlapping(
632            &mut levels,
633            vec![
634                generate_table(4, 1, 100, 180, 2),
635                generate_table(5, 1, 400, 450, 2),
636                generate_table(6, 1, 600, 700, 2),
637            ],
638        );
639
640        let mut levels_handler = vec![LevelHandler::new(0), LevelHandler::new(1)];
641        let mut local_stats = LocalPickerStatistic::default();
642        levels_handler[0].add_pending_task(1, 4, &levels.l0.sub_levels[0].table_infos);
643        let ret = picker.pick_compaction(&levels, &levels_handler, &mut local_stats);
644        // Skip this compaction because the write amplification is too large.
645        assert!(ret.is_none());
646    }
647
648    #[test]
649    fn test_l0_to_l1_break_on_exceed_compaction_size() {
650        let mut local_stats = LocalPickerStatistic::default();
651        let mut l0 = generate_l0_overlapping_sublevels(vec![
652            vec![
653                generate_table(4, 1, 10, 90, 1),
654                generate_table(5, 1, 210, 220, 1),
655            ],
656            vec![generate_table(6, 1, 0, 100000, 1)],
657            vec![generate_table(7, 1, 0, 100000, 1)],
658        ]);
659        // We can set level_type only because the input above is valid.
660        for s in &mut l0.sub_levels {
661            s.level_type = LevelType::Nonoverlapping;
662        }
663        let levels = Levels {
664            l0,
665            levels: vec![generate_level(1, vec![generate_table(3, 1, 0, 100000, 1)])],
666            ..Default::default()
667        };
668        let levels_handler = vec![LevelHandler::new(0), LevelHandler::new(1)];
669
670        // Pick with large max_compaction_bytes results all sub levels included in input.
671        let config = Arc::new(
672            CompactionConfigBuilder::new()
673                .max_compaction_bytes(500000)
674                .sub_level_max_compaction_bytes(50000)
675                .max_bytes_for_level_base(500000)
676                .level0_sub_level_compact_level_count(1)
677                .build(),
678        );
679        // Only include sub-level 0 results will violate MAX_WRITE_AMPLIFICATION.
680        // So all sub-levels are included to make write amplification < MAX_WRITE_AMPLIFICATION.
681        let mut picker =
682            LevelCompactionPicker::new(1, config, Arc::new(CompactionDeveloperConfig::default()));
683        let ret = picker
684            .pick_compaction(&levels, &levels_handler, &mut local_stats)
685            .unwrap();
686        assert_eq!(ret.input_levels[0].table_infos[0].sst_id, 7);
687        assert_eq!(
688            3,
689            ret.input_levels.iter().filter(|l| l.level_idx == 0).count()
690        );
691        assert_eq!(
692            4,
693            ret.input_levels
694                .iter()
695                .filter(|l| l.level_idx == 0)
696                .map(|l| l.table_infos.len())
697                .sum::<usize>()
698        );
699
700        // Pick with small max_compaction_bytes results partial sub levels included in input.
701        let config = Arc::new(
702            CompactionConfigBuilder::new()
703                .max_compaction_bytes(100010)
704                .max_bytes_for_level_base(512)
705                .level0_sub_level_compact_level_count(1)
706                .build(),
707        );
708        let mut picker =
709            LevelCompactionPicker::new(1, config, Arc::new(CompactionDeveloperConfig::default()));
710
711        let ret = picker
712            .pick_compaction(&levels, &levels_handler, &mut local_stats)
713            .unwrap();
714        assert_eq!(ret.input_levels[0].table_infos[0].sst_id, 6);
715        assert_eq!(
716            2,
717            ret.input_levels.iter().filter(|l| l.level_idx == 0).count()
718        );
719        assert_eq!(
720            3,
721            ret.input_levels
722                .iter()
723                .filter(|l| l.level_idx == 0)
724                .map(|l| l.table_infos.len())
725                .sum::<usize>()
726        );
727    }
728
729    #[test]
730    fn test_l0_to_l1_break_on_pending_sub_level() {
731        let l0 = generate_l0_nonoverlapping_multi_sublevels(vec![
732            vec![
733                generate_table(4, 1, 10, 90, 1),
734                generate_table(5, 1, 210, 220, 1),
735            ],
736            vec![generate_table(6, 1, 0, 100000, 1)],
737            vec![generate_table(7, 1, 0, 100000, 1)],
738        ]);
739
740        let levels = Levels {
741            l0,
742            levels: vec![generate_level(1, vec![generate_table(3, 1, 0, 100000, 1)])],
743            ..Default::default()
744        };
745        let mut levels_handler = vec![LevelHandler::new(0), LevelHandler::new(1)];
746        let mut local_stats = LocalPickerStatistic::default();
747
748        // Create a pending sub-level.
749        let pending_level = levels.l0.sub_levels[1].clone();
750        assert_eq!(pending_level.sub_level_id, 1);
751        let tier_task_input = CompactionInput {
752            input_levels: vec![InputLevel {
753                level_idx: 0,
754                level_type: pending_level.level_type,
755                table_infos: pending_level.table_infos.clone(),
756            }],
757            target_level: 1,
758            target_sub_level_id: pending_level.sub_level_id,
759            ..Default::default()
760        };
761        assert!(!levels_handler[0].is_level_pending_compact(&pending_level));
762        tier_task_input.add_pending_task(1, &mut levels_handler);
763        assert!(levels_handler[0].is_level_pending_compact(&pending_level));
764
765        // Pick with large max_compaction_bytes results all sub levels included in input.
766        let config = Arc::new(
767            CompactionConfigBuilder::new()
768                .max_compaction_bytes(500000)
769                .level0_sub_level_compact_level_count(2)
770                .build(),
771        );
772
773        // Only include sub-level 0 results will violate MAX_WRITE_AMPLIFICATION.
774        // But stopped by pending sub-level when trying to include more sub-levels.
775        let mut picker = LevelCompactionPicker::new(
776            1,
777            config.clone(),
778            Arc::new(CompactionDeveloperConfig::default()),
779        );
780        let ret = picker.pick_compaction(&levels, &levels_handler, &mut local_stats);
781        assert!(ret.is_none());
782
783        // Free the pending sub-level.
784        for pending_task_id in &levels_handler[0].pending_tasks_ids() {
785            levels_handler[0].remove_task(*pending_task_id);
786        }
787
788        // No more pending sub-level so we can get a task now.
789        let mut picker =
790            LevelCompactionPicker::new(1, config, Arc::new(CompactionDeveloperConfig::default()));
791        picker
792            .pick_compaction(&levels, &levels_handler, &mut local_stats)
793            .unwrap();
794    }
795
796    #[test]
797    fn test_l0_to_base_when_all_base_pending() {
798        let l0 = generate_l0_nonoverlapping_multi_sublevels(vec![
799            vec![
800                generate_table(4, 1, 10, 90, 1),
801                generate_table(5, 1, 1000, 2000, 1),
802            ],
803            vec![generate_table(6, 1, 10, 90, 1)],
804        ]);
805
806        let levels = Levels {
807            l0,
808            levels: vec![generate_level(1, vec![generate_table(3, 1, 1, 100, 1)])],
809            ..Default::default()
810        };
811        let mut levels_handler = vec![LevelHandler::new(0), LevelHandler::new(1)];
812        let mut local_stats = LocalPickerStatistic::default();
813
814        let config = Arc::new(
815            CompactionConfigBuilder::new()
816                .max_compaction_bytes(500000)
817                .level0_sub_level_compact_level_count(2)
818                .sub_level_max_compaction_bytes(1000)
819                .build(),
820        );
821
822        let mut picker =
823            LevelCompactionPicker::new(1, config, Arc::new(CompactionDeveloperConfig::default()));
824        let ret = picker
825            .pick_compaction(&levels, &levels_handler, &mut local_stats)
826            .unwrap();
827        // 1. trivial_move
828        assert_eq!(2, ret.input_levels.len());
829        assert!(ret.input_levels[1].table_infos.is_empty());
830        assert_eq!(5, ret.input_levels[0].table_infos[0].sst_id);
831        ret.add_pending_task(0, &mut levels_handler);
832
833        let ret = picker
834            .pick_compaction(&levels, &levels_handler, &mut local_stats)
835            .unwrap();
836        assert_eq!(3, ret.input_levels.len());
837        assert_eq!(6, ret.input_levels[0].table_infos[0].sst_id);
838    }
839}