feat(amber): columnar wire format, operator contract, scan and filter
@Ma77Ball ci sta già lavorando.
Dal 17/9/2026.
Valutazione
Questa issue non è ancora stata valutata.
Descrizione
Feature Summary
In one sentence: lay the foundation of columnar execution, the Arrow wire format and the opt-in operator contract, and prove it end to end with two operators (the CSV scan and the filter).
Parent: #8556 (opt-in columnar execution). This is PR 1 of the stacked series and pairs with apache/texera#8558.
What is this?
Before any operator can be made faster, two things must exist: a way to carry a batch of columns between workers, and a contract that lets an operator opt in to reading those columns. This issue adds both, then wires up the two simplest operators (scan and filter) so the whole path can be tested honestly.
Think of it as laying one lane of a new highway and driving two cars down it, while the old road stays open and default.
Proposed Solution or Design
The two new primitives.
ColumnarFrame: a data payload that carries one Arrow batch (the raw column bytes) plus a row count. It rides alongside the existing per-rowDataFrame.ColumnarOperatorExecutor/ColumnarResult: the opt-in contract. An operator can implementprocessColumnarBatch(...)and answerEmit(I made a new batch),Consumed(I absorbed it), orUnsupported(decode it and run the row path).
%%{init: {'theme':'dark', 'themeVariables': {'background':'#000000','lineColor':'#0F766E'}}}%%
flowchart LR
SCAN[CSV scan: read file straight into Arrow columns] --> WIRE[ColumnarFrame on the wire]
WIRE --> FILT[filter: keep rows on the column, no per-row decode]
FILT --> TERM[terminal]
classDef default fill:#000,color:#fff,stroke:#888,stroke-width:1px
How the engine routes a batch. The DataProcessor (the per-worker loop that runs the operator) checks whether the operator understands columns; if not, it decodes to rows. OutputManager, the partitioner, and the input side carry the batch end to end.
%%{init: {'theme':'dark', 'themeVariables': {'background':'#000000','lineColor':'#000000'}}}%%
flowchart TD
F{ColumnarFrame and<br/>operator opts in?} -->|yes| C[processColumnarBatch]
F -->|no| R[decode to rows, row path]
classDef default fill:#000,color:#fff,stroke:#888,stroke-width:1px
style C stroke:#1B7F3B
style R stroke:#B0451E
What lands here. ColumnarFrame, the contract, ArrowUtils (serialize/deserialize a batch), engine plumbing (DataProcessor, OutputManager, partitioner, input side), the Arrow-producing CSVScanSourceOpExec, and the Arrow-consuming SpecializedFilterOpExec. All behind a flag; default off.
| Row path (default) | Columnar path (flag on) | |
|---|---|---|
| scan output | one Tuple per row |
Arrow batch of columns |
| filter | evaluate per row | keep-mask over a column |
| between workers | N envelopes | 1 Arrow buffer |
Verified: the Arrow round-trip is lossless across all types, the vectorized filter matches the row filter exactly, and the existing DataProcessingSpec passes with the flag on and off.
High-level overview. Part of #8556.
- Lingua principale
- Scala
- Stelle
- 316
- Fork
- 189
- Merge medio
- 2g 20h
- PR unite (30g)
- 198
Guida per i contributori
Apri la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di apache/texera
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 86/100
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100
Tutte le issue di apache/texera
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 62/100
ergoplatform/ergodocs#614 ·
-
area:ci enhancement requires-triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 84/100
apache/datafusion-comet#6078 ·
-
[VL] madvise(WILLNEED) call fails in MmapFileStream because of wrong calculation of fetching length Apertabug triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 82/100
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 76/100
chipsalliance/rocket-chip#3831 ·
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 90/100