docs: add EXPIRE ROWS materialized-view documentation#468
Open
nwoolmer wants to merge 2 commits into
Open
Conversation
Deep-dive concept page (concepts/deep-dive/expire-rows.md) for passthrough materialized views with EXPIRE ROWS: all modes, worked examples, read-filter/cleanup mechanics, NULL/ties/monotonicity semantics, and limitations. Adds an ALTER MATERIALIZED VIEW SET EXPIRE reference page, an EXPIRE ROWS section in CREATE MATERIALIZED VIEW, and sidebar entries. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
nwoolmer
added
documentation
|
🚀 Build success! Latest successful preview: https://preview-468--questdb-documentation.netlify.app/docs/ Commit SHA: 3fd5d8d
|
Corrections and additions ported from the core repo's in-repo design doc (docs/row-expiry.md, now removed there): - Aggregating views are ACCEPTED with a logged advisory, not rejected (the previously-cited error message does not exist); reworded the concept note, Requirements, the ALTER behavior and errors tables, and the CREATE section accordingly. - materialized_views() exposes the policy as expire_clause, not expire_predicate. - Monotonicity: list the exact clock shapes the cleanup job proves monotonic (bare clock, clock minus non-negative constant, fixed-unit look-back dateadd) and that calendar units, look-forward offsets, compound arithmetic, and window predicates skip cleanup; the job skips rather than risks deleting rows. - No-policied-chains rule: CREATE rejects a defining query reading a policied view (base or join); SET EXPIRE is rejected with dependent views; corresponding errors added to the ALTER page. - Reserved __qdb_re_keep column name; no line comments inside the clause; CLEANUP EVERY strict <number><unit> grammar (s/m/h/d/w). - Kill switch is read at startup (restart required); failing sweeps back off from 1s up to a 10-minute cap. - Parquet side effect: compacting a partially-expired Parquet partition rewrites it as native storage until re-conversion. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Deep-dive concept page (concepts/deep-dive/expire-rows.md) for passthrough materialized views with EXPIRE ROWS: all modes, worked examples, read-filter/cleanup mechanics, NULL/ties/monotonicity semantics, and limitations. Adds an ALTER MATERIALIZED VIEW SET EXPIRE reference page, an EXPIRE ROWS section in CREATE MATERIALIZED VIEW, and sidebar entries.