Altinity / Altinity/altinity-sql-browser
Live visualizations for streaming queries: sliding-window aggregates and animated updates
Nessuno ha ancora preso questa issue.
- Lingua principale
- TypeScript
- Stelle
- 8
- Fork
- 2
- Merge medio
- 1h 34m
- PR unite (30g)
- 6
Descrizione
Context
#59 covers the safe baseline for ClickHouse SELECT … STREAM: bounded memory,
throttled rendering, live lifecycle, Stop behavior, and table tailing.
This issue covers the next layer: making streaming results visually useful.
The goal is not just an appending table. The goal is live values that visibly move:
bars grow and reorder, pie slices resize, stat cells tick, and changed values are easy
to notice.
Problem
The ClickHouse stream is append-only raw rows. For live charts, the browser cannot
assume the server sends updated aggregate rows.
The browser needs a client-side rollup over a bounded window, then it needs to update
existing visualizations in place instead of rebuilding them for every chunk.
Proposed work
- Add a pure client-side aggregation window in
src/core/.- count-based window, for example last N rows;
- optional time-based window, for example last 60 seconds when a timestamp column exists;
- group-by accumulators for count/sum/avg/min/max where feasible;
- deterministic eviction so memory stays bounded.
- Reuse existing chart selection/pivot logic where possible, especially
src/core/chart-data.js. - Update Chart.js instances in place with
chart.update()instead of destroying/recreating the canvas per chunk. - Batch chart updates on the same render cadence as the streaming table.
- Add live stat/table-cell affordances.
- changed numeric cells briefly highlight or count up;
- support
prefers-reduced-motion; - show the active window, for example
last 10k rowsorlast 60s.
- Keep the raw tail table and aggregate chart views as two views over the same feed state.
Suggested architecture
| Area | Proposed location | Notes |
|---|---|---|
| Window policy | src/core/stream.js or src/core/stream-window.js |
Count/time window, eviction, received/dropped counters |
| Aggregation | src/core/stream-aggregate.js |
Pure fold/evict logic |
| Chart model | src/core/chart-data.js |
Reuse/extend existing chart preparation |
| Render scheduling | src/core/stream.js + UI rAF glue |
Pure throttle decision; UI owns timers |
| Animation/UI | src/ui/results.js, src/styles.css |
In-place chart updates, cell transitions, reduced-motion support |
Acceptance criteria
- A streaming query can feed a chart without unbounded memory growth.
- Chart updates are batched and smooth under sustained row arrival.
- Existing chart instances are updated in place where possible.
- The UI makes the aggregation window explicit.
- Aggregation, eviction, null handling, and update batching decisions have unit coverage.
- Motion can be reduced through standard reduced-motion preferences.
Open questions
- Should the default chart window be last-N-rows, time-based, or user-selectable per query?
- Should dimension/measure selection reuse the current Chart view controls, or should live mode expose a simplified picker?
- Which aggregations are first scope: count only, count/sum/avg, or broader numeric aggregations?
- How should high-cardinality dimensions work: top-K with
Other, hard cap, or explicit user choice? - Should a
STREAM LIMITquery use the live chart path while running and then settle into a normal finite chart when complete?
Non-goals
- Enabling ClickHouse streaming settings on behalf of the user.
- Server-side incremental aggregation.
- A new charting dependency unless Chart.js proves insufficient.
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.
Direzione di ricerca
Inizia leggendo src/core/stream.js, src/core/chart-data.js, src/ui/results.js e src/styles.css per comprendere i percorsi esistenti di streaming e dei grafici. Risolvi le domande elencate relative a finestra, aggregazione, controlli del grafico e alta cardinalità prima di procedere con l’implementazione. Il lavoro è completo quando sono presenti un’aggregazione vincolata, aggiornamenti del grafico raggruppati in-place, uno stato esplicito della finestra, il supporto per il movimento ridotto e la copertura con unit test delle decisioni di aggregazione ed eviction.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Valutazione
- Stack tecnologico
- chart.js, typescript
- Ambito
- data-visualization, frontend, stream-processing, testing-qa
- Tipo di issue
- Funzionalità
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Stato di attività
- Tranquilla
- Chiarezza
- Abbastanza chiara
- Idoneità per principianti
- 35/100