Skip to main content

Module shadow

walrust

Module shadow 

Source
Expand description

Shadow WAL implementation for walrust

The shadow WAL provides a staging area for WAL frames that decouples the upload process from SQLite’s active WAL file. This matches Litestream’s architecture and provides several benefits:

  1. No file contention with SQLite during uploads
  2. Checkpoint control - we prevent auto-checkpoints
  3. Preserved history - shadow keeps frames even after checkpoint
  4. Decoupled I/O - upload doesn’t block write path

Structs§

ShadowSegment
A segment file in the shadow WAL
ShadowWal
Shadow WAL manager for a single database