Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document merge selection algorithm #3202

Open
rschu1ze opened this issue Feb 5, 2025 · 0 comments
Open

Document merge selection algorithm #3202

rschu1ze opened this issue Feb 5, 2025 · 0 comments
Assignees
Labels
docs rotation Docs rotation task P2

Comments

@rschu1ze
Copy link
Member

rschu1ze commented Feb 5, 2025

Our user docs should describe at a high level how the default merge selector algorithm in ClickHouse work (i.e. which parts are selected for merge based on what criteria). The description would fit here or here. We should note that that thresholds and details of the algorithms are not part of the stable database interface, the docs would only apply to the latest version and they may change between versions (this already applies to system tables, for example).

The current heuristics are described

  • here (I was told the logic did not change significantly since 2020), and
  • here (as source code comments). The heuristics were made exchangeable recently and there are more of them but SimpleMergeSelector is the default one.

In case of questions, @Michicosun can help.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs rotation Docs rotation task P2
Projects
None yet
Development

No branches or pull requests

3 participants