Skip to content

Conversation

@uicosp
Copy link
Contributor

@uicosp uicosp commented Aug 29, 2025

[core] Fix checkpoint recovery failure for compacted changelog files

Purpose

Fixes checkpoint recovery failures when using precommit-compact functionality introduced in commit [flink] add coordinate and worker operator for small changelog files compaction (#4380).

Root Cause:
Compacted changelog files have two types of file names:

  1. Real files: compacted-changelog-xxx$bid-len.cc-format
  2. Fake files: compacted-changelog-xxx$bid-len-off-len2.cc-format

Fake file names point to segments of real files but don't exist in the filesystem. The checkFilesExistence method was directly checking these fake file paths, causing recovery failures.

Solution:

  • Created CompactedChangelogPathResolver utility class to resolve fake file paths to real file paths
  • Modified TableCommitImpl.checkFilesExistence() to resolve all paths before checking existence
  • Added deduplication logic since multiple fake files may resolve to the same real file
  • Path resolution rules:
    • Real files (xxx$bid-len.cc-format): return original path
    • Fake files (xxx$bid-len-off-len2.cc-format): resolve to bucket-bid/xxx$bid-len.cc-format

Tests

  • Added unit tests in CompactedChangelogPathResolverTest to verify path resolution logic
  • Existing checkpoint recovery tests should now pass with compacted changelog files

API and Format

No changes to public API or storage format. This is an internal fix for file path resolution.

Documentation

No new features introduced. This is a bug fix for existing precommit-compact functionality.

* Utility class for resolving compacted changelog file paths.
*
* <p>This class provides functionality to resolve fake compacted changelog file paths to their real
* file paths, following the same protocol as CompactedChangelogFormatReaderFactory.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you also move logic codes into this class from CompactedChangelogFormatReaderFactory? It is better to keep protocol in one single class.

*/
public static Path resolveCompactedChangelogPath(Path path) {
// Check if this is a compacted changelog file by its .cc- extension
String[] nameAndFormat = path.getName().split("\\.");
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe just create a method isCompactedChangelogPath. And just check it is starting with compacted-changelog-?

@JingsongLi
Copy link
Contributor

Thanks @uicosp for the contribution! Left comments.

@uicosp
Copy link
Contributor Author

uicosp commented Sep 5, 2025

Refactor:

  1. Extract decodePath logic from CompactedChangelogFormatReaderFactory into CompactedChangelogPathResolver.
  2. Introduce isCompactedChangelogPath to check whether a file is a compacted changelog (by prefix "compacted-changelog-").

@JingsongLi JingsongLi merged commit 92e2f55 into apache:master Sep 11, 2025
23 checks passed
jerry-024 added a commit to jerry-024/paimon that referenced this pull request Sep 15, 2025
* upstream/master: (23 commits)
  [flink] Use Paimon format table read for flink (apache#6246)
  [core] Ensure system tables use the correct identifier for loadTableToken in RESTTokenFileIO. (apache#6247)
  [spark] Enhance v1 write merge schema test coverage (apache#6249)
  [spark] Eliminate duplicate convertLiteral invocations (apache#6250)
  [python] Fix failing to read 1000cols (apache#6244)
  [python] Expose CatalogFactory and Schema directly (apache#6243)
  [doc] Modify Python API to JVM free (apache#6242)
  [python] Fix multiple write brefore once commit  (apache#6241)
  [core] Support push down branchesTable by branchName (apache#6231)
  [cdc] Fix PostgreSQL DECIMAL type conversion issue (apache#6239)
  [arrow] Optimize Arrow string write performance (apache#6240)
  [core] Fix checkpoint recovery failure for compacted changelog files (apache#6173)
  [core] RESTCatalog: add DLF OSS endpoint support and improve configuration merge (apache#6232)
  [core] fix RESTCatalog#listViews for system database (apache#6233)
  [core] Introduce 'ignore-update-before' to ignore UD only (apache#6235)
  [python] Fix DLF partition statistical error (apache#6237)
  [python] Add _VALUE_STATS_COLS param to fix parse wrong bytes (apache#6234)
  [ci] Rename to Python Check Code Style and Test
  [python] Rename binary row to generic row
  [hotfix] Remove methods in SchemaManager for SchemasTable
  ...
zhuyufeng0809 pushed a commit to zhuyufeng0809/flink-table-store that referenced this pull request Sep 18, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants