Struct WriteSetStats 

pub struct WriteSetStats {
    pub page_limit: usize,
    pub byte_limit: usize,
    pub current_dirty_pages: usize,
    pub current_dirty_bytes: usize,
    pub dirty_pages_high_water: usize,
    pub dirty_bytes_high_water: usize,
    pub cap_refusals: u64,
}

Identity-bound digest of a complete SQLite main-database image.

The digest covers the page size, exact file length, page numbers, and all logical database pages. SQLite’s reserved lock-byte page is deliberately excluded because it is process-lock state rather than database content. Dirty-write-set accounting since the write-set ceiling was installed.

Distinct from page-cache residency: PageCachePeakSnapshot answers “how many pages were resident”, which is a memory bound. This answers “how large did one live transaction’s caller-staged write set become”, which is the ceiling a bounded builder enforces and what a residency peak cannot substitute for. It does not count the union of pages rewritten by separate transactions.

cap_refusals is the honest counterpart to the ceiling: a bound that was never approached and a bound that refused work both leave the same high-water mark, and only this distinguishes them.

Fields

page_limit: usize

Maximum distinct dirty pages admitted to one transaction.

byte_limit: usize

Exact byte ceiling implied by page_limit * page_size.

current_dirty_pages: usize

Distinct dirty pages currently staged by the active transaction.

current_dirty_bytes: usize

Exact bytes currently staged by the active transaction.

dirty_pages_high_water: usize

Largest live caller-staged dirty-page count observed in any one transaction since the ceiling was installed.

This is a window-wide maximum of per-transaction cardinalities, not the union of distinct pages touched by all transactions in the window.

dirty_bytes_high_water: usize

Largest staged byte count observed since the ceiling was installed.

cap_refusals: u64

Pre-admission cap refusals since the ceiling was installed.

Trait Implementations

impl Clone for WriteSetStats

fn clone(&self) -> WriteSetStats

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for WriteSetStats

impl Debug for WriteSetStats

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

Formats the value using the given formatter.

impl Default for WriteSetStats

fn default() -> WriteSetStats

Returns the “default value” for a type.

impl Eq for WriteSetStats

impl PartialEq for WriteSetStats

fn eq(&self, other: &WriteSetStats) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for WriteSetStats