Struct SqliteStoreConfig 

pub struct SqliteStoreConfig {

    pub busy_timeout_ms: u64,
    pub enable_wal: bool,
    pub synchronous_normal: bool,
    pub page_size_bytes: u32,
    pub page_cache_size_bytes: u64,
    pub wal_autocheckpoint_pages: u32,
    pub node_read_cache_size_bytes: usize,
    pub node_compression_min_bytes: usize,
    pub mmap_size_bytes: u64,
    pub reader_connections: usize,
    pub primary_reader_uses_writer: bool,
    pub node_read_cache_shards: usize,
    pub max_batch_select_keys: usize,
    pub background_checkpoints: bool,
    pub checkpoint_wal_bytes: u64,
    pub checkpoint_interval_ms: u64,
    pub journal_size_limit_bytes: u64,
    pub group_commit_delay_micros: u64,
    pub group_commit_max_nodes: usize,
}

Configuration options for SqliteStore.

Fields

busy_timeout_ms: u64

Busy timeout in milliseconds for contended SQLite locks.

enable_wal: bool

Enable WAL journaling for file-backed databases.

synchronous_normal: bool

Set SQLite synchronous mode to NORMAL when applying default pragmas.

page_size_bytes: u32

Page size requested when creating a new SQLite database.

Existing databases retain the page size stored in their file header.

page_cache_size_bytes: u64

Maximum bytes retained in SQLite’s page cache for this connection.

A larger cache prevents dirty B-tree pages from being spilled and rewritten repeatedly during large prolly-node publications.

wal_autocheckpoint_pages: u32

Number of WAL pages that triggers an automatic checkpoint.

This should be large enough that a normal node publication commits without performing checkpoint I/O in its latency-sensitive path.

node_read_cache_size_bytes: usize

Maximum decoded node bytes retained by the adapter.

This cache complements SQLite’s encoded page cache and lets immutable nodes written earlier in the process satisfy later shared reads without another SQL lookup or decompression.

node_compression_min_bytes: usize

Minimum serialized node size considered for LZ4 compression.

Smaller values favor database size and cold I/O; larger values avoid compression CPU for latency-sensitive in-process publication.

mmap_size_bytes: u64

Maximum database bytes SQLite may access through memory-mapped reads.

This avoids per-page read syscalls for large immutable prolly nodes while retaining SQLite’s normal transactional and durability guarantees.

reader_connections: usize

Number of read-only SQLite connections used for concurrent cache misses, scans, and manifest reads. In-memory and externally supplied connections use the writer connection regardless of this value.

primary_reader_uses_writer: bool

Let the first thread that reads from a file-backed store reuse the writer connection. This preserves the single-thread page and statement cache fast path while other threads use the read-only pool.

node_read_cache_shards: usize

Number of independently locked decoded-node cache shards.

max_batch_select_keys: usize

Maximum SQLite variables used by one native multi-key read statement.

background_checkpoints: bool

Run passive WAL checkpoints on a dedicated connection instead of in the latency-sensitive commit path.

checkpoint_wal_bytes: u64

Run a passive checkpoint after the WAL file reaches this allocation.

checkpoint_interval_ms: u64

Maximum delay between background checkpoint inspections.

journal_size_limit_bytes: u64

Maximum retained WAL allocation after the log is reset.

group_commit_delay_micros: u64

Optional window used to combine concurrent immutable-node publications into one durable SQLite transaction. Zero disables group commit.

group_commit_max_nodes: usize

Maximum number of nodes combined in one grouped publication transaction.

Trait Implementations

impl Clone for SqliteStoreConfig

fn clone(&self) -> SqliteStoreConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SqliteStoreConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SqliteStoreConfig

fn default() -> Self

Returns the “default value” for a type.