Tutorials

Three walkthroughs that each end with something running. Every command is copyable, and every number quoted is one the tool prints for itself.

01 · 15 minutes

Building a 5-million-row in-memory tick store in 60 seconds

Generate a realistic session, stamp the attributes that make the as-of join a binary search, run TAQ analytics, and check the memory footprint with \v.

02 · 40 minutes

Setting up an end-to-end Grafana & Amber dashboard pipeline

Store → marts → amberd → the Go datasource → provisioned panels. Including the two failures that look like something else.

03 · 20 minutes

Interoperability: Arrow record batches from Amber to Python without copying

Prove pointer identity, stream 400 million rows a batch at a time, and understand the one lifetime rule that makes it safe.

Before you start

All three assume the engine is built. Tutorials 2 and 3 also need the shared library and the Python bindings.

git clone https://github.com/BonucciAndrea/amber && cd amber
chmod +x a build.sh install.sh
./build.sh --shared          # ./amber + libamber.so
./a                          # sanity: the REPL opens

See the installation guide if anything there surprises you.