btrdb · research

BTrDB

BTrDB is a time-series database that stores versioned time-value streams in a time-partitioned copy-on-write tree with subtree summaries.

Related Observatory article: BTrDB on hesela.com

The FAST 2016 design stores raw points in leaves and summary statistics in internal nodes. Version annotations let it locate modified time ranges without comparing aggregate values. [1]

Python v5.34.2 documents power-of-two aligned windows, half-open time bounds and omission of empty windows. Its annotation version is separate from the data-stream version. [2]

Go bindings v5.17.1 widen changed ranges at coarser resolution. A returned range is not a list of changed samples. Query results must be checked for terminal errors even when some values arrived. [3]

Identical count, minimum, mean and maximum do not establish identical samples or temporal order. The linked synthetic examples demonstrate this limitation without executing BTrDB. [4]

Relations

related
Copy-on-write (storage), Storage snapshot

Citations

  1. Andersen and Culler. BTrDB: Optimizing Storage System Design for Timeseries Processing. FAST 2016, pp. 39-52, sections 3-4 and 6.3. (accessed 2026-11-14)
  2. BTrDB Python v5.34.2 documentation: aligned_windows and stream annotations. (accessed 2026-11-14)
  3. BTrDB Go bindings v5.17.1: Changes, LatestVersion and query-channel completion. (accessed 2026-11-14)
  4. Hesela: time-series rollups, versioned changes and exact synthetic counterexamples. (accessed 2026-11-14)
Sources & caveats
  • The 2016 research design and later client documentation are separate versions.
  • Source review and synthetic arithmetic only; no BTrDB server, crash test or performance reproduction.

JSON: /data/terms/btrdb.json

Published by Hesela team · Updated

Report a correction · Editorial standards · Reuse guidance

Cite this page
Hesela team. BTrDB. Hesela. 2026-11-14. https://hesela.dev/terms/btrdb/