Enum OnConflict 

pub enum OnConflict {
    Error,
    Skip,
    Replace,
}

What a batch node insert does when its key is already taken.

A mirror rebuild writes a frame onto a store that already has content, so “the key exists” is a routine answer rather than a failure. The decision is made during the batch’s existing validate pass, from one id-map lookup per row, so the frame stays atomic and re-ingest stays O(n).

Variants

Error

Refuse the whole frame with GraphError::DuplicateKey. The default, and the only behaviour before v0.6.10.

Skip

Leave the stored node exactly as it is — properties, label and edges — and count it in BatchOutcome::skipped.

Replace

Keep the key and make the node’s properties exactly the supplied props: supplied fields are set, fields absent from the supplied props are removed. A supplied label that differs from the stored one, and a supplied ns that would move the node, are row errors — relabelling is GraphDb::rename_node, not a side effect of a rebuild.

Two properties are outside “exactly”, both because they are not the caller’s to supply:

• ns is immutable, so an omitted ns leaves the node where it is rather than moving it to default;
• a property a view owns is kept, not removed. Supplying one is a row error, so omitting it cannot be a request to delete it, and refusing the row instead would make Replace impossible for the whole population a view has written to. Each such field kept is counted in BatchOutcome::kept_view_owned — the row is still replaced and still raises no row error, so that count is the only signal a caller gets that the stored node carries a field its frame did not describe.

Trait Implementations

impl Clone for OnConflict

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for OnConflict

impl Debug for OnConflict

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

Formats the value using the given formatter.

impl Default for OnConflict

fn default() -> Self

Returns the “default value” for a type.

impl Eq for OnConflict

impl PartialEq for OnConflict

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for OnConflict