Skip to content

fix(global-index): support external path for global index checkpoints - #473

Merged
lxy-9602 merged 2 commits into
apache:mainfrom
lszskye:checkpoint_external
Oct 28, 2026
Merged

lxy-9602 merged 2 commits into
apache:mainfrom
lszskye:checkpoint_external

Conversation

@lszskye

@lszskye lszskye commented Oct 27, 2026

Copy link
Copy Markdown
Collaborator

Purpose

Linked issue: #382

Global index checkpoints currently use the table's index directory even
when global-index.external-path is configured.

This change makes checkpoint writes, recovery, and cleanup use
<global-index.external-path>/checkpoint/<task_id> when configured.
Without an external path, checkpoints remain under
<table_path>/index/checkpoint/<task_id>.

Task cleanup resolves the external path from table schema options and
caller overrides, preserving other tasks' checkpoints and completed
index files.

Tests

src/paimon/core/global_index/global_index_file_manager_test.cpp
src/paimon/core/utils/file_store_path_factory_test.cpp
test/inte/global_index_test.cpp

Documentation

  • Document checkpoint locations, cleanup configuration, and task ID
    uniqueness across tables sharing an external index directory.
  • Clarify filesystem error propagation in the cleanup API.
  • Move full-text predicate and root TopK usage documentation from the API
    reference into the user guide.

lxy-9602
lxy-9602 previously approved these changes Oct 28, 2026

@lxy-9602 lxy-9602 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

+1

@lxy-9602 lxy-9602 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

+1

@lxy-9602
lxy-9602 merged commit bb7cb2e into apache:main Oct 28, 2026
16 checks passed
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.

2 participants