Struct StagedWrite 

pub struct StagedWrite {
    pub transaction: Transaction,
    pub new_fragments: Vec<Fragment>,
    pub removed_fragment_ids: Vec<u64>,
}

A Lance write that has produced fragment files on object storage but is not yet committed to the dataset’s manifest. The staged-write primitives are consumed by MutationStaging (exec/staging.rs, exec/mutation.rs) and the bulk loader (loader/mod.rs). The intent: defer Lance commits to end-of-query so a mid-query failure leaves the touched table at the pre-mutation HEAD instead of drifting ahead. See docs/runs.md for the publisher-CAS contract this builds on.

transaction is opaque from our side — Lance owns its semantics. We commit it via CommitBuilder::execute(transaction) (see TableStore::commit_staged).

For read-your-writes within the same query, new_fragments and removed_fragment_ids together describe the post-stage view delta: scan_with_staged (and count_rows_with_staged) compose committed - removed + new so subsequent reads see the staged result without double-counting fragments that Operation::Update rewrote. Without removed_fragment_ids, a stage_merge_insert that rewrites existing fragments would yield duplicate rows (the original fragment stays in the committed manifest while its rewrite shows up in new_fragments).

Fields

transaction: Transaction

new_fragments: Vec<Fragment>

Fragments to surface alongside the committed manifest in Scanner::with_fragments(committed - removed + new). For Operation::Append these are the freshly-appended fragments. For Operation::Update (merge_insert) these are updated_fragments + new_fragments (rewrites + freshly-inserted rows).

removed_fragment_ids: Vec<u64>

Fragment IDs that this staged write supersedes. The committed manifest must filter these out before being combined with new_fragments for read-your-writes scans, otherwise rewrites yield duplicate rows. Empty for stage_append (Operation::Append adds without removing anything); populated from Operation::Update.removed_fragment_ids for stage_merge_insert.

Trait Implementations

impl Clone for StagedWrite

fn clone(&self) -> StagedWrite

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StagedWrite

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

Formats the value using the given formatter.