apache / apache/fluss

[Umbrella] Rescale buckets for future partitions

Open
#4,288 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Java
Stars
2.1k
Forks
625
Avg merge
3d 14h
Merged PRs (30d)
97

Description

### Search before asking

- [x] I searched the existing issues and found no umbrella issue tracking this work.

### Description

This umbrella issue tracks support for changing the bucket count of future partitions, together with the recovery coverage and client improvements needed around this feature.

Changing a partitioned table's `bucket.num` should affect only partitions created after the change. Existing partitions retain their original bucket counts, without data redistribution or lake-file rewrites. Reads, writes, and recovery must therefore work correctly when partitions of the same table have different bucket counts.

### Sub-issues

- #3907 — Core support for per-partition bucket rescaling, implemented in #3908: persist and propagate each partition's bucket count and use it for routing while allowing the table default to change for future partitions.
- #4280 — Add aggregation recovery tests across partitions with different bucket counts. Cover both restoration from a real aggregation checkpoint and recovery through producer offsets without a checkpoint, including another failure during recovery. Exercise multiple operator subtasks and verify exact aggregate results with no duplicate application or data loss.
- #4287 — Keep dynamic partition writes non-blocking with asynchronous partition creation and metadata refresh. Use fresh partition metadata when forming new batches and validate each queued batch's original routing at send time, failing incompatible batches rather than silently changing their routing.
- #4289 — Add feature introduction and usage documentation, including runnable examples for increasing and decreasing future partitions' bucket counts, existing/pre-created partition semantics, and supported configurations and compatibility requirements.

### Delivery scope

The core feature is tracked by #3907 and PR #3908. The recovery tests, asynchronous write-path improvement, and user documentation are tracked independently in the sub-issues above. In particular, #4287 is a follow-up to be addressed in a separate PR after #3908; it is not required to be implemented within #3908.

This umbrella remains open until all sub-issues are completed.

### Are you willing to submit a PR?

- [ ] I'm willing to submit a PR.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reading the linked core work in #3907 and implemented PR #3908, then choose one independent sub-issue: #4280 for aggregation recovery tests, #4287 for asynchronous dynamic-partition writes, or #4289 for feature documentation. Read the selected sub-issue first and verify completion against its stated recovery, routing, or documentation requirements.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
databases, distributed-systems
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
20/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.