Struct BulkInterrupted 

pub struct BulkInterrupted {
    pub written: usize,
    pub cause: DbError,
}

A chunked bulk write that stopped partway, and how much of it landed (0.13.8, W7.6, D-181).

The four chunked paths — crate::Database::bulk_import, write_concepts, upsert_embeddings and write_analytics_annotations — are atomic per chunk and not overall, so a failure at row 19,000 of 20,000 leaves the first 18,000-odd rows committed. Until 0.13.8 they returned a bare DbError and the caller was told only that it failed: the count was computed, used to size the next chunk, and dropped on the floor at the ?. A caller who then retried the whole batch re-wrote everything that had already landed, and one who skipped it lost the tail.

This is why those four return Result<usize, BulkInterrupted> rather than Result. From<BulkInterrupted> for DbError exists so ? still works in a function returning Result — that conversion is how a caller says the count does not interest them, and it says so at the call site instead of silently.

Fields

written: usize

Rows the chunks that finished before the stop committed, and which are still committed. Zero is an ordinary value: the first chunk can fail.

cause: DbError

Why it stopped. DbError::BulkCancelled if the caller asked; otherwise whatever the failing chunk raised, unchanged — this is not a new error, it is the same one with the count attached.

Implementations

impl BulkInterrupted

pub fn was_cancelled(&self) -> bool

Whether the stop was the caller’s own cancellation rather than a fault.

Trait Implementations

impl Debug for BulkInterrupted

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

Formats the value using the given formatter.

impl Display for BulkInterrupted

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

Formats the value using the given formatter.

impl Error for BulkInterrupted

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BulkInterrupted> for DbError

fn from(e: BulkInterrupted) -> Self

Discards written. That is the point: a caller writing ? into a function returning Result has decided the partial count is not something they will act on, and this puts that decision at the place it is taken rather than inside the crate.