risingwave_meta/hummock/compaction/picker/
min_overlap_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::sync::Arc;
16
17use risingwave_hummock_sdk::append_sstable_info_to_string;
18use risingwave_hummock_sdk::level::{InputLevel, Level, Levels};
19use risingwave_hummock_sdk::sstable_info::SstableInfo;
20use risingwave_pb::hummock::LevelType;
21
22use super::{CompactionInput, CompactionPicker, LocalPickerStatistic};
23use crate::hummock::compaction::overlap_strategy::OverlapStrategy;
24use crate::hummock::level_handler::LevelHandler;
25
26pub struct MinOverlappingPicker {
27    level: usize,
28    target_level: usize,
29    max_select_bytes: u64,
30    vnode_partition_count: u32,
31    overlap_strategy: Arc<dyn OverlapStrategy>,
32}
33
34impl MinOverlappingPicker {
35    pub fn new(
36        level: usize,
37        target_level: usize,
38        max_select_bytes: u64,
39        vnode_partition_count: u32,
40        overlap_strategy: Arc<dyn OverlapStrategy>,
41    ) -> MinOverlappingPicker {
42        MinOverlappingPicker {
43            level,
44            target_level,
45            max_select_bytes,
46            vnode_partition_count,
47            overlap_strategy,
48        }
49    }
50
51    pub fn pick_tables(
52        &self,
53        select_tables: &[SstableInfo],
54        target_tables: &[SstableInfo],
55        level_handlers: &[LevelHandler],
56    ) -> (Vec<SstableInfo>, Vec<SstableInfo>) {
57        let mut select_file_ranges = vec![];
58        for (idx, sst) in select_tables.iter().enumerate() {
59            if level_handlers[self.level].is_pending_compact(&sst.sst_id) {
60                continue;
61            }
62            let mut overlap_info = self.overlap_strategy.create_overlap_info();
63            overlap_info.update(&sst.key_range);
64            let overlap_files_range = overlap_info.check_multiple_overlap(target_tables);
65
66            if overlap_files_range.is_empty() {
67                return (vec![sst.clone()], vec![]);
68            }
69            select_file_ranges.push((idx, overlap_files_range));
70        }
71        select_file_ranges.retain(|(_, range)| {
72            let mut pending_compact = false;
73            for other in &target_tables[range.clone()] {
74                if level_handlers[self.target_level].is_pending_compact(&other.sst_id) {
75                    pending_compact = true;
76                    break;
77                }
78            }
79            !pending_compact
80        });
81
82        let mut min_score = u64::MAX;
83        let mut min_score_select_range = 0..0;
84        let mut min_score_target_range = 0..0;
85        let mut min_score_select_file_size = 0;
86        for left in 0..select_file_ranges.len() {
87            let mut select_file_size = 0;
88            let mut target_level_overlap_range = select_file_ranges[left].1.clone();
89            let mut total_file_size = 0;
90            for other in &target_tables[target_level_overlap_range.clone()] {
91                total_file_size += other.sst_size;
92            }
93            let start_idx = select_file_ranges[left].0;
94            let mut end_idx = start_idx + 1;
95            for (idx, range) in select_file_ranges.iter().skip(left) {
96                if select_file_size > self.max_select_bytes
97                    || *idx > end_idx
98                    || range.start >= target_level_overlap_range.end
99                {
100                    break;
101                }
102                select_file_size += select_tables[*idx].sst_size;
103                if range.end > target_level_overlap_range.end {
104                    for other in &target_tables[target_level_overlap_range.end..range.end] {
105                        total_file_size += other.sst_size;
106                    }
107                    target_level_overlap_range.end = range.end;
108                }
109                let score = if select_file_size == 0 {
110                    total_file_size
111                } else {
112                    total_file_size * 100 / select_file_size
113                };
114                end_idx = idx + 1;
115                if score < min_score
116                    || (score == min_score && select_file_size < min_score_select_file_size)
117                {
118                    min_score = score;
119                    min_score_select_range = start_idx..end_idx;
120                    min_score_target_range = target_level_overlap_range.clone();
121                    min_score_select_file_size = select_file_size;
122                }
123            }
124        }
125        if min_score == u64::MAX {
126            return (vec![], vec![]);
127        }
128        let select_input_ssts = select_tables[min_score_select_range].to_vec();
129        let target_input_ssts = target_tables[min_score_target_range].to_vec();
130        (select_input_ssts, target_input_ssts)
131    }
132}
133
134impl CompactionPicker for MinOverlappingPicker {
135    fn pick_compaction(
136        &mut self,
137        levels: &Levels,
138        level_handlers: &[LevelHandler],
139        stats: &mut LocalPickerStatistic,
140    ) -> Option<CompactionInput> {
141        assert!(self.level > 0);
142        let (select_input_ssts, target_input_ssts) = self.pick_tables(
143            &levels.get_level(self.level).table_infos,
144            &levels.get_level(self.target_level).table_infos,
145            level_handlers,
146        );
147        if select_input_ssts.is_empty() {
148            stats.skip_by_pending_files += 1;
149            return None;
150        }
151        Some(CompactionInput {
152            select_input_size: select_input_ssts.iter().map(|sst| sst.sst_size).sum(),
153            target_input_size: target_input_ssts.iter().map(|sst| sst.sst_size).sum(),
154            total_file_count: (select_input_ssts.len() + target_input_ssts.len()) as u64,
155            input_levels: vec![
156                InputLevel {
157                    level_idx: self.level as u32,
158                    level_type: LevelType::Nonoverlapping,
159                    table_infos: select_input_ssts,
160                },
161                InputLevel {
162                    level_idx: self.target_level as u32,
163                    level_type: LevelType::Nonoverlapping,
164                    table_infos: target_input_ssts,
165                },
166            ],
167            target_level: self.target_level,
168            vnode_partition_count: self.vnode_partition_count,
169            ..Default::default()
170        })
171    }
172}
173
174#[derive(Default, Debug)]
175pub struct SubLevelSstables {
176    pub total_file_size: u64,
177    pub total_file_count: usize,
178    pub sstable_infos: Vec<(u64, Vec<SstableInfo>)>,
179    pub expected: bool,
180}
181
182pub struct NonOverlapSubLevelPicker {
183    min_compaction_bytes: u64,
184    max_compaction_bytes: u64,
185    min_expected_level_count: usize,
186    max_file_count: u64,
187    overlap_strategy: Arc<dyn OverlapStrategy>,
188    enable_check_task_level_overlap: bool,
189    max_expected_level_count: usize,
190    enable_optimize_l0_interval_selection: bool,
191}
192
193impl NonOverlapSubLevelPicker {
194    pub fn new(
195        min_compaction_bytes: u64,
196        max_compaction_bytes: u64,
197        min_expected_level_count: usize,
198        max_file_count: u64,
199        overlap_strategy: Arc<dyn OverlapStrategy>,
200        enable_check_task_level_overlap: bool,
201        max_expected_level_count: usize,
202        enable_optimize_l0_interval_selection: bool,
203    ) -> Self {
204        Self {
205            min_compaction_bytes,
206            max_compaction_bytes,
207            min_expected_level_count,
208            max_file_count,
209            overlap_strategy,
210            enable_check_task_level_overlap,
211            max_expected_level_count,
212            enable_optimize_l0_interval_selection,
213        }
214    }
215
216    #[cfg(test)]
217    pub fn for_test(
218        min_compaction_bytes: u64,
219        max_compaction_bytes: u64,
220        min_expected_level_count: usize,
221        max_file_count: u64,
222        overlap_strategy: Arc<dyn OverlapStrategy>,
223        enable_check_task_level_overlap: bool,
224        max_expected_level_count: usize,
225        enable_optimize_l0_interval_selection: bool,
226    ) -> Self {
227        Self {
228            min_compaction_bytes,
229            max_compaction_bytes,
230            min_expected_level_count,
231            max_file_count,
232            overlap_strategy,
233            enable_check_task_level_overlap,
234            max_expected_level_count,
235            enable_optimize_l0_interval_selection,
236        }
237    }
238
239    // Use the incoming sst as the basic range and select as many sub levels as possible
240    // 1. Build basic range based on sst
241    // 2. Add a new sub level in each round
242    // 3. Expand sst according to the basic range from new to old sub levels.
243    // 4. According to the size and count restrictions, select the plan that contains the most sub levels as much as possible
244    fn pick_sub_level(
245        &self,
246        levels: &[Level],
247        level_handler: &LevelHandler,
248        sst: &SstableInfo,
249    ) -> Option<SubLevelSstables> {
250        let mut ret = SubLevelSstables::default();
251        for sub_level in levels {
252            ret.sstable_infos.push((sub_level.sub_level_id, vec![]));
253        }
254
255        let mut pick_levels_range = Vec::default();
256        let mut max_select_level_count = 0;
257
258        // Pay attention to the order here: Make sure to select the lowest sub_level to meet the requirements of base compaction. If you break the assumption of this order, you need to redesign it.
259        // TODO: Use binary selection to replace the step algorithm to optimize algorithm complexity
260        'expand_new_level: for (target_index, target_level) in levels.iter().enumerate() {
261            if target_level.level_type != LevelType::Nonoverlapping {
262                break;
263            }
264
265            if ret
266                .sstable_infos
267                .iter()
268                .filter(|(_sub_level_id, ssts)| !ssts.is_empty())
269                .count()
270                > self.max_expected_level_count
271            {
272                break;
273            }
274
275            // reset the `basic_overlap_info` with basic sst
276            let mut basic_overlap_info = self.overlap_strategy.create_overlap_info();
277            basic_overlap_info.update(&sst.key_range);
278
279            let mut overlap_files_range =
280                basic_overlap_info.check_multiple_include(&target_level.table_infos);
281            if overlap_files_range.is_empty() {
282                overlap_files_range =
283                    basic_overlap_info.check_multiple_overlap(&target_level.table_infos);
284            }
285
286            if overlap_files_range.is_empty() {
287                continue;
288            }
289
290            let mut overlap_levels = vec![];
291
292            let mut add_files_size: u64 = 0;
293            let mut add_files_count: usize = 0;
294
295            let mut select_level_count = 0;
296            for reverse_index in (0..=target_index).rev() {
297                let target_tables = &levels[reverse_index].table_infos;
298
299                overlap_files_range = if target_index == reverse_index {
300                    overlap_files_range
301                } else {
302                    basic_overlap_info.check_multiple_overlap(target_tables)
303                };
304
305                // We allow a layer in the middle without overlap, so we need to continue to
306                // the next layer to search for overlap
307                if overlap_files_range.is_empty() {
308                    // empty level
309                    continue;
310                }
311
312                for other in &target_tables[overlap_files_range.clone()] {
313                    if level_handler.is_pending_compact(&other.sst_id) {
314                        break 'expand_new_level;
315                    }
316                    basic_overlap_info.update(&other.key_range);
317
318                    add_files_size += other.sst_size;
319                    add_files_count += 1;
320                }
321
322                overlap_levels.push((reverse_index, overlap_files_range.clone()));
323                select_level_count += 1;
324            }
325
326            if select_level_count > max_select_level_count {
327                max_select_level_count = select_level_count;
328                pick_levels_range = overlap_levels;
329            }
330
331            // When size / file count has exceeded the limit, we need to abandon this plan, it cannot be expanded to the last sub_level
332            if max_select_level_count >= self.min_expected_level_count
333                && (add_files_size >= self.max_compaction_bytes
334                    || add_files_count >= self.max_file_count as usize)
335            {
336                break 'expand_new_level;
337            }
338        }
339
340        if !pick_levels_range.is_empty() {
341            for (reverse_index, sst_range) in pick_levels_range {
342                let level_ssts = &levels[reverse_index].table_infos;
343                ret.sstable_infos[reverse_index].1 = level_ssts[sst_range].to_vec();
344                ret.total_file_count += ret.sstable_infos[reverse_index].1.len();
345                ret.total_file_size += ret.sstable_infos[reverse_index]
346                    .1
347                    .iter()
348                    .map(|sst| sst.sst_size)
349                    .sum::<u64>();
350            }
351
352            // sort sst per level due to reverse expand
353            ret.sstable_infos
354                .iter_mut()
355                .for_each(|(_sub_level_id, level_ssts)| {
356                    level_ssts.sort_by(|sst1, sst2| sst1.key_range.cmp(&sst2.key_range));
357                });
358        } else {
359            ret.total_file_count = 0;
360            ret.total_file_size = 0;
361        }
362
363        if self.enable_check_task_level_overlap {
364            self.verify_task_level_overlap(&ret, levels);
365        }
366
367        ret.sstable_infos
368            .retain(|(_sub_level_id, ssts)| !ssts.is_empty());
369
370        // To check whether the task is expected
371        if ret.total_file_size > self.max_compaction_bytes
372            || ret.total_file_count as u64 > self.max_file_count
373            || ret.sstable_infos.len() > self.max_expected_level_count
374        {
375            // rotate the sstables to meet the `max_file_count` and `max_compaction_bytes` and `max_expected_level_count`
376            let mut total_file_count = 0;
377            let mut total_file_size = 0;
378            let mut total_level_count = 0;
379            for (index, (_sub_level_id, sstables)) in ret.sstable_infos.iter().enumerate() {
380                total_file_count += sstables.len();
381                total_file_size += sstables.iter().map(|sst| sst.sst_size).sum::<u64>();
382                total_level_count += 1;
383
384                // Atleast `min_expected_level_count`` level should be selected
385                if total_level_count >= self.min_expected_level_count
386                    && (total_file_count as u64 >= self.max_file_count
387                        || total_file_size >= self.max_compaction_bytes
388                        || total_level_count >= self.max_expected_level_count)
389                {
390                    ret.total_file_count = total_file_count;
391                    ret.total_file_size = total_file_size;
392                    ret.sstable_infos.truncate(index + 1);
393                    break;
394                }
395            }
396        }
397
398        if ret.sstable_infos.is_empty() {
399            return None;
400        }
401
402        Some(ret)
403    }
404
405    pub fn pick_l0_multi_non_overlap_level(
406        &self,
407        l0: &[Level],
408        level_handler: &LevelHandler,
409    ) -> Vec<SubLevelSstables> {
410        if l0.len() < self.min_expected_level_count {
411            return vec![];
412        }
413
414        let mut scores = vec![];
415        // To find the sub_level with the most files;
416        let intervals_level_idx = if self.enable_optimize_l0_interval_selection {
417            l0.iter()
418                .enumerate()
419                .max_by(|(idx1, levels1), (idx2, levels2)| {
420                    levels1
421                        .table_infos
422                        .len()
423                        .cmp(&levels2.table_infos.len())
424                        .then(idx2.cmp(idx1))
425                })
426                .map(|(idx, _)| idx)
427                .unwrap()
428        } else {
429            0
430        };
431
432        let intervals = &l0[intervals_level_idx].table_infos;
433        for sst in intervals {
434            if level_handler.is_pending_compact(&sst.sst_id) {
435                continue;
436            }
437
438            if let Some(score) = self.pick_sub_level(l0, level_handler, sst) {
439                scores.push(score);
440            }
441        }
442
443        if scores.is_empty() {
444            return vec![];
445        }
446
447        let mut expected = Vec::with_capacity(scores.len());
448        let mut unexpected = vec![];
449
450        for mut selected_task in scores {
451            if selected_task.sstable_infos.len() > self.max_expected_level_count
452                || selected_task.sstable_infos.len() < self.min_expected_level_count
453                || selected_task.total_file_size < self.min_compaction_bytes
454            {
455                selected_task.expected = false;
456                unexpected.push(selected_task);
457            } else {
458                selected_task.expected = true;
459                expected.push(selected_task);
460            }
461        }
462
463        // The logic of sorting depends on the interval we expect to select.
464        // 1. contain as many levels as possible
465        // 2. fewer files in the bottom sub level, containing as many smaller intervals as possible.
466        expected.sort_by(|a, b| {
467            b.sstable_infos
468                .len()
469                .cmp(&a.sstable_infos.len())
470                .then_with(|| a.total_file_count.cmp(&b.total_file_count))
471                .then_with(|| a.total_file_size.cmp(&b.total_file_size))
472        });
473
474        // For unexpected tasks, We devised a separate algorithm to evaluate the priority of a task, based on the limit passed in,
475        // we set tasks close to the limit to be high priority, here have three attributes:
476        // 1. The number of levels selected is close to the limit
477        // 2. The number of files selected is close to the limit
478        // 3. The size of the selected file is close to the limit
479        unexpected.sort_by(|a, b| {
480            let a_select_count_offset =
481                (a.sstable_infos.len() as i64 - self.max_expected_level_count as i64).abs();
482            let b_select_count_offset =
483                (b.sstable_infos.len() as i64 - self.max_expected_level_count as i64).abs();
484
485            let a_file_count_offset =
486                (a.total_file_count as i64 - self.max_file_count as i64).abs();
487            let b_file_count_offset =
488                (b.total_file_count as i64 - self.max_file_count as i64).abs();
489
490            let a_file_size_offset =
491                (a.total_file_size as i64 - self.max_compaction_bytes as i64).abs();
492            let b_file_size_offset =
493                (b.total_file_size as i64 - self.max_compaction_bytes as i64).abs();
494
495            a_select_count_offset
496                .cmp(&b_select_count_offset)
497                .then_with(|| a_file_count_offset.cmp(&b_file_count_offset))
498                .then_with(|| a_file_size_offset.cmp(&b_file_size_offset))
499        });
500
501        expected.extend(unexpected);
502
503        expected
504    }
505
506    fn verify_task_level_overlap(&self, ret: &SubLevelSstables, levels: &[Level]) {
507        use std::fmt::Write;
508
509        use itertools::Itertools;
510
511        use crate::hummock::compaction::overlap_strategy::OverlapInfo;
512        let mut overlap_info: Option<Box<dyn OverlapInfo>> = None;
513        for (level_idx, (_sub_level_id, ssts)) in ret.sstable_infos.iter().enumerate().rev() {
514            if let Some(overlap_info) = overlap_info.as_mut() {
515                // skip the check if `overlap_info` is not initialized (i.e. the first non-empty level is not met)
516                let level = levels.get(level_idx).unwrap();
517                let overlap_sst_range = overlap_info.check_multiple_overlap(&level.table_infos);
518                if !overlap_sst_range.is_empty() {
519                    let expected_sst_ids = level.table_infos[overlap_sst_range.clone()]
520                        .iter()
521                        .map(|s| s.object_id)
522                        .collect_vec();
523                    let actual_sst_ids = ssts.iter().map(|s| s.object_id).collect_vec();
524                    // `actual_sst_ids` can be larger than `expected_sst_ids` because we may use a larger key range to select SSTs.
525                    // `expected_sst_ids` must be a sub-range of `actual_sst_ids` to ensure correctness.
526                    let start_idx = actual_sst_ids
527                        .iter()
528                        .position(|sst_id| sst_id == expected_sst_ids.first().unwrap());
529                    if start_idx.is_none_or(|idx| {
530                        actual_sst_ids[idx..idx + expected_sst_ids.len()] != expected_sst_ids
531                    }) {
532                        // Print SstableInfo for `actual_sst_ids`
533                        let mut actual_sst_infos = String::new();
534                        ssts.iter()
535                            .for_each(|s| append_sstable_info_to_string(&mut actual_sst_infos, s));
536
537                        // Print SstableInfo for `expected_sst_ids`
538                        let mut expected_sst_infos = String::new();
539                        level.table_infos[overlap_sst_range].iter().for_each(|s| {
540                            append_sstable_info_to_string(&mut expected_sst_infos, s)
541                        });
542
543                        // Print SstableInfo for selected ssts in all sub-levels
544                        let mut ret_sst_infos = String::new();
545                        ret.sstable_infos.iter().enumerate().for_each(
546                            |(idx, (_sub_level_id, ssts))| {
547                                writeln!(
548                                    ret_sst_infos,
549                                    "sub level {}",
550                                    levels.get(idx).unwrap().sub_level_id
551                                )
552                                .unwrap();
553                                ssts.iter().for_each(|s| {
554                                    append_sstable_info_to_string(&mut ret_sst_infos, s)
555                                });
556                            },
557                        );
558                        panic!(
559                            "Compact task overlap check fails. Actual: {} Expected: {} Ret {}",
560                            actual_sst_infos, expected_sst_infos, ret_sst_infos
561                        );
562                    }
563                }
564            } else if !ssts.is_empty() {
565                // init the `overlap_info` when meeting the first non-empty level.
566                overlap_info = Some(self.overlap_strategy.create_overlap_info());
567            }
568
569            for sst in ssts {
570                overlap_info.as_mut().unwrap().update(&sst.key_range);
571            }
572        }
573    }
574}
575
576#[cfg(test)]
577pub mod tests {
578    use std::collections::BTreeSet;
579
580    use risingwave_common::config::meta::default::compaction_config;
581
582    use super::*;
583    use crate::hummock::compaction::overlap_strategy::RangeOverlapStrategy;
584    use crate::hummock::compaction::selector::tests::{
585        generate_l0_nonoverlapping_sublevels, generate_table,
586    };
587
588    #[test]
589    fn test_compact_l1() {
590        let mut picker =
591            MinOverlappingPicker::new(1, 2, 10000, 0, Arc::new(RangeOverlapStrategy::default()));
592        let levels = vec![
593            Level {
594                level_idx: 1,
595                level_type: LevelType::Nonoverlapping,
596                table_infos: vec![
597                    generate_table(0, 1, 0, 100, 1),
598                    generate_table(1, 1, 101, 200, 1),
599                    generate_table(2, 1, 222, 300, 1),
600                ],
601                ..Default::default()
602            },
603            Level {
604                level_idx: 2,
605                level_type: LevelType::Nonoverlapping,
606                table_infos: vec![
607                    generate_table(4, 1, 0, 100, 1),
608                    generate_table(5, 1, 101, 150, 1),
609                    generate_table(6, 1, 151, 201, 1),
610                    generate_table(7, 1, 501, 800, 1),
611                    generate_table(8, 2, 301, 400, 1),
612                ],
613                ..Default::default()
614            },
615        ];
616        let levels = Levels {
617            levels,
618            l0: generate_l0_nonoverlapping_sublevels(vec![]),
619            ..Default::default()
620        };
621        let mut level_handlers = vec![
622            LevelHandler::new(0),
623            LevelHandler::new(1),
624            LevelHandler::new(2),
625        ];
626
627        // pick a non-overlapping files. It means that this file could be trivial move to next
628        // level.
629        let mut local_stats = LocalPickerStatistic::default();
630        let ret = picker
631            .pick_compaction(&levels, &level_handlers, &mut local_stats)
632            .unwrap();
633        assert_eq!(ret.input_levels[0].level_idx, 1);
634        assert_eq!(ret.target_level, 2);
635        assert_eq!(ret.input_levels[0].table_infos.len(), 1);
636        assert_eq!(ret.input_levels[0].table_infos[0].sst_id, 2);
637        assert_eq!(ret.input_levels[1].table_infos.len(), 0);
638        ret.add_pending_task(0, &mut level_handlers);
639
640        let ret = picker
641            .pick_compaction(&levels, &level_handlers, &mut local_stats)
642            .unwrap();
643        assert_eq!(ret.input_levels[0].level_idx, 1);
644        assert_eq!(ret.target_level, 2);
645        assert_eq!(ret.input_levels[0].table_infos.len(), 1);
646        assert_eq!(ret.input_levels[0].table_infos[0].sst_id, 0);
647        assert_eq!(ret.input_levels[1].table_infos.len(), 1);
648        assert_eq!(ret.input_levels[1].table_infos[0].sst_id, 4);
649        ret.add_pending_task(1, &mut level_handlers);
650
651        let ret = picker
652            .pick_compaction(&levels, &level_handlers, &mut local_stats)
653            .unwrap();
654        assert_eq!(ret.input_levels[0].table_infos.len(), 1);
655        assert_eq!(ret.input_levels[0].table_infos[0].sst_id, 1);
656        assert_eq!(ret.input_levels[1].table_infos.len(), 2);
657        assert_eq!(ret.input_levels[1].table_infos[0].sst_id, 5);
658    }
659
660    #[test]
661    fn test_expand_l1_files() {
662        let mut picker =
663            MinOverlappingPicker::new(1, 2, 10000, 0, Arc::new(RangeOverlapStrategy::default()));
664        let levels = vec![
665            Level {
666                level_idx: 1,
667                level_type: LevelType::Nonoverlapping,
668                table_infos: vec![
669                    generate_table(0, 1, 50, 99, 2),
670                    generate_table(1, 1, 100, 149, 2),
671                    generate_table(2, 1, 150, 249, 2),
672                ],
673                ..Default::default()
674            },
675            Level {
676                level_idx: 2,
677                level_type: LevelType::Nonoverlapping,
678                table_infos: vec![
679                    generate_table(4, 1, 50, 199, 1),
680                    generate_table(5, 1, 200, 399, 1),
681                ],
682                ..Default::default()
683            },
684        ];
685        let levels = Levels {
686            levels,
687            l0: generate_l0_nonoverlapping_sublevels(vec![]),
688            ..Default::default()
689        };
690        let levels_handler = vec![
691            LevelHandler::new(0),
692            LevelHandler::new(1),
693            LevelHandler::new(2),
694        ];
695
696        // pick a non-overlapping files. It means that this file could be trivial move to next
697        // level.
698        let ret = picker
699            .pick_compaction(
700                &levels,
701                &levels_handler,
702                &mut LocalPickerStatistic::default(),
703            )
704            .unwrap();
705        assert_eq!(ret.input_levels[0].level_idx, 1);
706        assert_eq!(ret.input_levels[1].level_idx, 2);
707
708        assert_eq!(ret.input_levels[0].table_infos.len(), 2);
709        assert_eq!(ret.input_levels[0].table_infos[0].sst_id, 0);
710        assert_eq!(ret.input_levels[0].table_infos[1].sst_id, 1);
711
712        assert_eq!(ret.input_levels[1].table_infos.len(), 1);
713        assert_eq!(ret.input_levels[1].table_infos[0].sst_id, 4);
714    }
715
716    #[test]
717    fn test_pick_l0_multi_level() {
718        let levels = vec![
719            Level {
720                level_idx: 1,
721                level_type: LevelType::Nonoverlapping,
722                table_infos: vec![
723                    generate_table(0, 1, 50, 99, 2),
724                    generate_table(1, 1, 100, 149, 2),
725                    generate_table(2, 1, 150, 249, 2),
726                    generate_table(6, 1, 250, 300, 2),
727                    generate_table(7, 1, 350, 400, 2),
728                    generate_table(8, 1, 450, 500, 2),
729                ],
730                total_file_size: 800,
731                ..Default::default()
732            },
733            Level {
734                level_idx: 2,
735                level_type: LevelType::Nonoverlapping,
736                table_infos: vec![
737                    generate_table(4, 1, 50, 199, 1),
738                    generate_table(5, 1, 200, 249, 1),
739                    generate_table(9, 1, 250, 300, 2),
740                    generate_table(10, 1, 350, 400, 2),
741                    generate_table(11, 1, 450, 500, 2),
742                ],
743                total_file_size: 350,
744                ..Default::default()
745            },
746            Level {
747                level_idx: 3,
748                level_type: LevelType::Nonoverlapping,
749                table_infos: vec![
750                    generate_table(11, 1, 250, 300, 2),
751                    generate_table(12, 1, 350, 400, 2),
752                    generate_table(13, 1, 450, 500, 2),
753                ],
754                total_file_size: 150,
755                ..Default::default()
756            },
757            Level {
758                level_idx: 4,
759                level_type: LevelType::Nonoverlapping,
760                table_infos: vec![
761                    generate_table(14, 1, 250, 300, 2),
762                    generate_table(15, 1, 350, 400, 2),
763                    generate_table(16, 1, 450, 500, 2),
764                ],
765                total_file_size: 150,
766                ..Default::default()
767            },
768        ];
769
770        let levels_handlers = [
771            LevelHandler::new(0),
772            LevelHandler::new(1),
773            LevelHandler::new(2),
774        ];
775
776        {
777            // no limit
778            let picker = NonOverlapSubLevelPicker::new(
779                0,
780                10000,
781                1,
782                10000,
783                Arc::new(RangeOverlapStrategy::default()),
784                true,
785                compaction_config::max_l0_compact_level_count() as usize,
786                true,
787            );
788            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
789            assert_eq!(6, ret.len());
790        }
791
792        {
793            // limit max bytes
794            let picker = NonOverlapSubLevelPicker::new(
795                0,
796                100,
797                1,
798                10000,
799                Arc::new(RangeOverlapStrategy::default()),
800                true,
801                compaction_config::max_l0_compact_level_count() as usize,
802                true,
803            );
804            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
805            assert_eq!(6, ret.len());
806        }
807
808        {
809            // limit max file_count
810            let picker = NonOverlapSubLevelPicker::new(
811                0,
812                10000,
813                1,
814                5,
815                Arc::new(RangeOverlapStrategy::default()),
816                true,
817                compaction_config::max_l0_compact_level_count() as usize,
818                true,
819            );
820            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
821            assert_eq!(6, ret.len());
822        }
823    }
824
825    #[test]
826    fn test_pick_l0_multi_level2() {
827        let levels = vec![
828            Level {
829                level_idx: 1,
830                level_type: LevelType::Nonoverlapping,
831                table_infos: vec![
832                    generate_table(0, 1, 50, 99, 2),
833                    generate_table(1, 1, 100, 149, 2),
834                    generate_table(2, 1, 150, 249, 2),
835                    generate_table(6, 1, 250, 300, 2),
836                    generate_table(7, 1, 350, 400, 2),
837                    generate_table(8, 1, 450, 500, 2),
838                ],
839                total_file_size: 800,
840                ..Default::default()
841            },
842            Level {
843                level_idx: 2,
844                level_type: LevelType::Nonoverlapping,
845                table_infos: vec![
846                    generate_table(4, 1, 50, 99, 1),
847                    generate_table(5, 1, 150, 200, 1),
848                    generate_table(9, 1, 250, 300, 2),
849                    generate_table(10, 1, 350, 400, 2),
850                    generate_table(11, 1, 450, 500, 2),
851                ],
852                total_file_size: 250,
853                ..Default::default()
854            },
855            Level {
856                level_idx: 3,
857                level_type: LevelType::Nonoverlapping,
858                table_infos: vec![
859                    generate_table(11, 1, 250, 300, 2),
860                    generate_table(12, 1, 350, 400, 2),
861                    generate_table(13, 1, 450, 500, 2),
862                ],
863                total_file_size: 150,
864                ..Default::default()
865            },
866            Level {
867                level_idx: 4,
868                level_type: LevelType::Nonoverlapping,
869                table_infos: vec![
870                    generate_table(14, 1, 250, 300, 2),
871                    generate_table(15, 1, 350, 400, 2),
872                    generate_table(16, 1, 450, 500, 2),
873                ],
874                total_file_size: 150,
875                ..Default::default()
876            },
877        ];
878
879        let levels_handlers = [
880            LevelHandler::new(0),
881            LevelHandler::new(1),
882            LevelHandler::new(2),
883        ];
884
885        {
886            // no limit
887            let picker = NonOverlapSubLevelPicker::new(
888                0,
889                10000,
890                1,
891                10000,
892                Arc::new(RangeOverlapStrategy::default()),
893                true,
894                compaction_config::max_l0_compact_level_count() as usize,
895                true,
896            );
897            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
898            assert_eq!(6, ret.len());
899        }
900
901        {
902            // limit max bytes
903            let max_compaction_bytes = 100;
904            let picker = NonOverlapSubLevelPicker::new(
905                60,
906                max_compaction_bytes,
907                1,
908                10000,
909                Arc::new(RangeOverlapStrategy::default()),
910                true,
911                compaction_config::max_l0_compact_level_count() as usize,
912                true,
913            );
914            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
915            assert_eq!(6, ret.len());
916
917            for plan in &ret {
918                if plan.total_file_size >= max_compaction_bytes {
919                    assert!(plan.expected);
920                } else {
921                    assert!(!plan.expected);
922                }
923            }
924        }
925
926        {
927            // limit max file_count
928            let max_file_count = 2;
929            let picker = NonOverlapSubLevelPicker::new(
930                0,
931                10000,
932                1,
933                max_file_count,
934                Arc::new(RangeOverlapStrategy::default()),
935                true,
936                compaction_config::max_l0_compact_level_count() as usize,
937                true,
938            );
939            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
940            assert_eq!(6, ret.len());
941
942            for plan in ret {
943                let mut sst_id_set = BTreeSet::default();
944                for sst in &plan.sstable_infos {
945                    sst_id_set.insert(sst.1[0].sst_id);
946                }
947                assert!(sst_id_set.len() <= max_file_count as usize);
948            }
949        }
950
951        {
952            // limit min_depth
953            let min_depth = 3;
954            let picker = NonOverlapSubLevelPicker::new(
955                10,
956                10000,
957                min_depth,
958                100,
959                Arc::new(RangeOverlapStrategy::default()),
960                true,
961                compaction_config::max_l0_compact_level_count() as usize,
962                true,
963            );
964            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
965            assert_eq!(6, ret.len());
966
967            for plan in ret {
968                if plan.sstable_infos.len() >= min_depth {
969                    assert!(plan.expected);
970                } else {
971                    assert!(!plan.expected);
972                }
973            }
974        }
975    }
976
977    #[test]
978    fn test_trivial_move_bug() {
979        let levels = [
980            Level {
981                level_idx: 1,
982                level_type: LevelType::Nonoverlapping,
983                table_infos: vec![generate_table(0, 1, 400, 500, 2)],
984                total_file_size: 100,
985                ..Default::default()
986            },
987            Level {
988                level_idx: 2,
989                level_type: LevelType::Nonoverlapping,
990                table_infos: vec![
991                    generate_table(1, 1, 100, 200, 1),
992                    generate_table(2, 1, 600, 700, 1),
993                ],
994                total_file_size: 200,
995                ..Default::default()
996            },
997            Level {
998                level_idx: 3,
999                level_type: LevelType::Nonoverlapping,
1000                table_infos: vec![
1001                    generate_table(3, 1, 100, 300, 2),
1002                    generate_table(4, 1, 600, 800, 1),
1003                ],
1004                total_file_size: 400,
1005                ..Default::default()
1006            },
1007        ];
1008
1009        let levels_handlers = vec![
1010            LevelHandler::new(0),
1011            LevelHandler::new(1),
1012            LevelHandler::new(2),
1013            LevelHandler::new(3),
1014        ];
1015        // no limit
1016        let picker =
1017            MinOverlappingPicker::new(2, 3, 1000, 0, Arc::new(RangeOverlapStrategy::default()));
1018        let (select_files, target_files) = picker.pick_tables(
1019            &levels[1].table_infos,
1020            &levels[2].table_infos,
1021            &levels_handlers,
1022        );
1023        let overlap_strategy = Arc::new(RangeOverlapStrategy::default());
1024        let mut overlap_info = overlap_strategy.create_overlap_info();
1025        for sst in &select_files {
1026            overlap_info.update(&sst.key_range);
1027        }
1028        let range = overlap_info.check_multiple_overlap(&levels[0].table_infos);
1029        assert!(range.is_empty());
1030        assert_eq!(select_files.len(), 1);
1031        assert_eq!(target_files.len(), 1);
1032    }
1033
1034    #[test]
1035    fn test_pick_unexpected_task() {
1036        let levels = vec![
1037            Level {
1038                level_idx: 1,
1039                level_type: LevelType::Nonoverlapping,
1040                table_infos: vec![generate_table(0, 1, 50, 100, 2)], // 50
1041                total_file_size: 50,
1042                ..Default::default()
1043            },
1044            Level {
1045                level_idx: 2,
1046                level_type: LevelType::Nonoverlapping,
1047                table_infos: vec![
1048                    generate_table(1, 1, 101, 150, 1), // 50
1049                ],
1050                total_file_size: 50,
1051                ..Default::default()
1052            },
1053            Level {
1054                level_idx: 3,
1055                level_type: LevelType::Nonoverlapping,
1056                table_infos: vec![
1057                    generate_table(2, 1, 151, 200, 2), // 50
1058                ],
1059                total_file_size: 50,
1060                ..Default::default()
1061            },
1062            Level {
1063                level_idx: 4,
1064                level_type: LevelType::Nonoverlapping,
1065                table_infos: vec![
1066                    generate_table(3, 1, 50, 300, 2), // 250
1067                ],
1068                total_file_size: 250,
1069                ..Default::default()
1070            },
1071        ];
1072
1073        let levels_handlers = [
1074            LevelHandler::new(0),
1075            LevelHandler::new(1),
1076            LevelHandler::new(2),
1077            LevelHandler::new(3),
1078            LevelHandler::new(4),
1079        ];
1080
1081        {
1082            // no limit
1083            let picker = NonOverlapSubLevelPicker::new(
1084                0,
1085                10000,
1086                1,
1087                10000,
1088                Arc::new(RangeOverlapStrategy::default()),
1089                true,
1090                compaction_config::max_l0_compact_level_count() as usize,
1091                true,
1092            );
1093            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
1094            {
1095                let plan = &ret[0];
1096                assert_eq!(4, plan.sstable_infos.len());
1097            }
1098        }
1099
1100        {
1101            // limit size
1102            let picker = NonOverlapSubLevelPicker::new(
1103                0,
1104                150,
1105                1,
1106                10000,
1107                Arc::new(RangeOverlapStrategy::default()),
1108                true,
1109                compaction_config::max_l0_compact_level_count() as usize,
1110                true,
1111            );
1112            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
1113            {
1114                let plan = &ret[0];
1115                assert_eq!(3, plan.sstable_infos.len());
1116            }
1117        }
1118
1119        {
1120            // limit count
1121            let picker = NonOverlapSubLevelPicker::new(
1122                0,
1123                10000,
1124                1,
1125                3,
1126                Arc::new(RangeOverlapStrategy::default()),
1127                true,
1128                compaction_config::max_l0_compact_level_count() as usize,
1129                true,
1130            );
1131            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
1132            {
1133                let plan = &ret[0];
1134                assert_eq!(3, plan.sstable_infos.len());
1135            }
1136        }
1137
1138        {
1139            // limit expected level count
1140            let max_expected_level_count = 3;
1141            let picker = NonOverlapSubLevelPicker::for_test(
1142                0,
1143                10000,
1144                1,
1145                3,
1146                Arc::new(RangeOverlapStrategy::default()),
1147                true,
1148                max_expected_level_count,
1149                true,
1150            );
1151            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
1152            {
1153                let plan = &ret[0];
1154                assert_eq!(max_expected_level_count, plan.sstable_infos.len());
1155
1156                assert_eq!(0, plan.sstable_infos[0].1[0].sst_id);
1157                assert_eq!(1, plan.sstable_infos[1].1[0].sst_id);
1158                assert_eq!(2, plan.sstable_infos[2].1[0].sst_id);
1159            }
1160        }
1161
1162        {
1163            // limit min_compacaion_bytes
1164            let max_expected_level_count = 100;
1165            let picker = NonOverlapSubLevelPicker::for_test(
1166                1000,
1167                10000,
1168                1,
1169                100,
1170                Arc::new(RangeOverlapStrategy::default()),
1171                true,
1172                max_expected_level_count,
1173                true,
1174            );
1175            let ret = picker.pick_l0_multi_non_overlap_level(&levels, &levels_handlers[0]);
1176            {
1177                let plan = &ret[0];
1178
1179                assert_eq!(0, plan.sstable_infos[0].1[0].sst_id);
1180                assert_eq!(1, plan.sstable_infos[1].1[0].sst_id);
1181                assert_eq!(2, plan.sstable_infos[2].1[0].sst_id);
1182                assert_eq!(3, plan.sstable_infos[3].1[0].sst_id);
1183                assert!(!plan.expected);
1184            }
1185        }
1186    }
1187}