Skip to content

docs(design): close-out disposition for #405 (re-measured on main) - #634

Merged
jdatcmd merged 1 commit into
commandprompt:mainfrom
ChronicallyJD:docs/405-closeout
Aug 14, 2026
Merged

docs(design): close-out disposition for #405 (re-measured on main)#634
jdatcmd merged 1 commit into
commandprompt:mainfrom
ChronicallyJD:docs/405-closeout

Conversation

@ChronicallyJD

Copy link
Copy Markdown
Collaborator

Docs-only close-out for #405 (materialization strategies from Abadi + X100). Appends a final disposition section to design/ISSUE_405_LATE_MATERIALIZATION.md, re-measured on current main (977bb44) so the issue can be reasonably closed. No code, no behaviour change.

What it records

Item 1 (position-list intersection before materialization) — measured again on main. Two queries returning the same 2,000 surviving rows on a 2,000,000-row fixture (pg18n non-assert, bloom off, serial):

shape pad decode (median/5) Rows Removed by Filter Vectors Skipped
packed (survivors in one vector) 28.9 ms 8,000 14
spread (one survivor per vector) 726.7 ms 1,998,000 0

Same survivor count, 25× the payload-decode cost, ~2M rows materialised to return 2,000 → decode tracks surviving vectors, not positions. We prune vectors, not positions; Abadi's bit-string intersection stays retracted (a measured trade, PR #601); the worthwhile subset shipped as the fold-path payload deferral (#617, test/native_fold_deferral.sh).

Item 2 (branch predication) — N/A: the tree builds no packed selection vector to predicate (those loops were deleted in #200). Recorded.

Item 3 (vector length vs column count) — reframed: COLUMNAR_NATIVE_VECTOR_LENGTH is vestigial (write-only catalog stamp, 3 sites); the execution stride is a literal and the runtime granularity knob is chunk_group_row_limit. Not a single tunable constant. Recorded.

Recommendation: CLOSE #405 — item 1 measured + dispositioned with the useful part shipped; items 2/3 recorded as the issue itself proposed.

Scope

Docs only (a design/ note; not user-facing docs/, so docs_style does not apply). No code, no CHANGELOG entry.

🤖 Generated with Claude Code

…d on main)

Records the final disposition of the three ranked items in commandprompt#405, re-measured
against current main so the issue can be closed:

- Item 1 (position-list intersection): MEASURED again on main 977bb44. Two
  queries returning the same 2,000 surviving rows show 25x the payload-decode
  cost (28.9 ms vs 726.7 ms) when survivors are spread one-per-vector, with
  1,998,000 rows removed by filter -- decode tracks surviving VECTORS not
  positions. We prune vectors, not positions; Abadi's full bit-string
  intersection stays retracted (a trade, not a free win, PR commandprompt#601); the
  worthwhile subset shipped as the fold-path payload deferral (commandprompt#617).
- Item 2 (branch predication): N/A -- the tree builds no packed selection
  vector to predicate (the selection loops were deleted in commandprompt#200). Recorded.
- Item 3 (vector length): reframed. COLUMNAR_NATIVE_VECTOR_LENGTH is vestigial
  (write-only catalog stamp); the execution stride is a literal and the runtime
  knob is chunk_group_row_limit. Not a single tunable constant. Recorded.

Docs only (design note); no code, no behaviour change. Recommends CLOSE.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TgAk1gqeME7DHpJw8xxybu
@jdatcmd
jdatcmd merged commit d984f9c into commandprompt:main Aug 14, 2026
10 of 12 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.

Opportunities from Abadi's materialization strategies and MonetDB/X100, with what we already implement

2 participants