Skip to content

[doc](query-cache) Document incremental merge in cloud mode#3999

Open
asdf2014 wants to merge 1 commit into
apache:masterfrom
asdf2014:query-cache-incremental-cloud-docs
Open

[doc](query-cache) Document incremental merge in cloud mode#3999
asdf2014 wants to merge 1 commit into
apache:masterfrom
asdf2014:query-cache-incremental-cloud-docs

Conversation

@asdf2014

@asdf2014 asdf2014 commented Jul 19, 2026

Copy link
Copy Markdown
Member

Versions

  • dev
  • 4.x
  • 3.x
  • 2.1 or older (not covered by version/language sync gate)

Languages

  • Chinese
  • English
  • Japanese candidate translation needed

Docs Checklist

  • Checked by AI
  • Test Cases Built
  • Updated required version and language counterparts, or explained why not
  • If only one language changed, confirmed whether source/translation counterparts need sync

Documents the cloud (compute-storage decoupled) support for Query Cache incremental merge: condition 3 now covers the per-tablet view sync and its fast-fail budget (query_cache_decision_sync_timeout_ms), adds the be.conf config row and the query_cache_decision_sync_time_ms metric, lists the two new cloud fallback reasons, adds a note on query_freshness_tolerance_ms / enable_prefer_cached_rowset, and updates the decision-flow diagram. Also corrects the JOIN caching FAQ (unrelated to the cloud work): a join in the cached subtree disables the cache structurally, while the aggregate-first-then-join rewrite additionally needs runtime_filter_mode=OFF for every joined table to be cached.

Code PR: apache/doris#65788

Follow-up to the incremental merge documentation for the cloud
(compute-storage decoupled) support:
- Condition 3 now states that the tablet view must be syncable to the queried
  version. This is trivial on local storage; on cloud the per-tablet decision
  first syncs the view (rowsets, and for merge-on-write tables the delete
  bitmap) with a fast-fail budget (query_cache_decision_sync_timeout_ms) so a
  slow meta service cannot hold the decision's admission thread.
- A note explains that query_freshness_tolerance_ms and
  enable_prefer_cached_rowset make a query read a version-inexact view, so it
  does not use incremental merge and, on cloud, also skips the cache
  write-back.
- Adds the query_cache_decision_sync_timeout_ms BE config row and the
  query_cache_decision_sync_time_ms metric, and lists the two new cloud
  fallback reasons (cloud rowset sync failed, cloud rowset sync timed out).
- Updates the decision-flow diagram accordingly.

Also corrects the JOIN caching FAQ (unrelated to the cloud work): a join in the
cached subtree disables the cache structurally, independent of runtime filters,
while the aggregate-first-then-join rewrite additionally needs
runtime_filter_mode=OFF for every joined table to be cached, not just the build
side.
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.

1 participant