Enum ConflictTarget 

pub enum ConflictTarget {
    PrimaryKey,
    Columns(&'static [&'static str]),
}

Conflict target for an upsert. Defaults to the model’s primary key (matching the previous PK-only behavior). Columns lets callers upsert on an arbitrary unique tuple — most commonly a natural key that’s distinct from the PK (e.g. (owner_id, provider) on a per-owner-and-provider settings row, or (pairing_id, slot) on a per-slot envelope).

The named columns MUST correspond to a UNIQUE constraint or UNIQUE index on the target table — the database engine enforces this and will surface a clear error if not. The upsert builder additionally requires the input to carry a value for every column in the target tuple, so the conflict probe (SELECT … FOR UPDATE) has something to filter on.

Composite-constraint-by-name (ON CONFLICT ON CONSTRAINT my_unique_idx_v2) is not yet exposed; pass the matching column tuple via Self::Columns instead.

Variants

PrimaryKey

The model’s @id primary key. Default.

Columns(&'static [&'static str])

A caller-supplied tuple of columns forming a unique key on the target table.

Implementations

impl ConflictTarget

pub const fn columns(cols: &'static [&'static str]) -> Self

Sugar for ConflictTarget::Columns(&[...]).

Trait Implementations

impl Clone for ConflictTarget

fn clone(&self) -> ConflictTarget

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ConflictTarget

impl Debug for ConflictTarget

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

Formats the value using the given formatter.

impl Default for ConflictTarget

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ConflictTarget

impl PartialEq for ConflictTarget

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ConflictTarget