Expand description
Streaming checkpoint support.
Provides optional, zero-overhead checkpointing for the streaming API. When disabled (the default), no runtime cost is incurred. When enabled, captures source sequences, watermarks, and persists checkpoint snapshots.
§Architecture
Ring 0 (Hot Path): Source.push() -> increment sequence (AtomicU64 Relaxed ~1ns)
Ring 1 (Background): StreamCheckpointManager.trigger() -> capture atomics -> store
Ring 2 (Control): LaminarDB.checkpoint() -> manual triggerStructs§
- Stream
Changelog Buffer - A pre-allocated ring buffer for changelog entries.
- Stream
Changelog Entry - A single changelog entry — fixed 24 bytes, no heap allocation.
- Stream
Checkpoint - A point-in-time snapshot of streaming pipeline state.
- Stream
Checkpoint Config - Configuration for streaming checkpoints.
- Stream
Checkpoint Manager - Coordinates checkpoint lifecycle for streaming sources and sinks.
Enums§
- Checkpoint
Error - Errors from checkpoint operations.
- Overflow
Policy - Policy when the changelog buffer is full.
- Stream
Change Op - Type of changelog operation.
- WalMode
- WAL mode for checkpoint durability.