Skip to content

Conversation

@evenyag
Copy link
Contributor

@evenyag evenyag commented Nov 5, 2025

I hereby agree to the terms of the GreptimeDB CLA.

Refer to a related PR or issue link (optional)

What's changed and what's your intention?

This PR implements an dedicated file cache for puffin files. It adds the following two options:

  • preload_index_cache: Preload index (puffin) files into cache on region open. This is enabled by default.
  • index_cache_percent: Percentage of write cache capacity allocated for index (puffin) files.

The FileCache adds another index to track puffin files under the write cache. When the engine opens a region, it creates a RegionLoadCacheTask to load the puffin files. The WriteCache runs the RegionLoadCacheTask after it finish recovery.

PR Checklist

Please convert it to a draft if some of the following conditions are not met.

  • I have written the necessary rustdoc comments.
  • I have added the necessary unit tests and integration tests.
  • This PR requires documentation updates.
  • API changes are backward compatible.
  • Schema or data changes are backward compatible.

@github-actions github-actions bot added size/M docs-not-required This change does not impact docs. labels Nov 5, 2025
@evenyag evenyag marked this pull request as ready for review November 7, 2025 13:23
@evenyag evenyag requested review from a team, v0y4g3r and waynexia as code owners November 7, 2025 13:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-not-required This change does not impact docs. size/M

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant