Struct OnConflictBuilder 

pub struct OnConflictBuilder<'a, S, T> { /* private fields */ }

Intermediate builder for typed ON CONFLICT clause construction (PostgreSQL).

Created by InsertBuilder::on_conflict() or InsertBuilder::on_conflict_on_constraint(). Call do_nothing() or do_update() to complete the clause.

Implementations

impl<'a, S, T> OnConflictBuilder<'a, S, T>

pub fn where<E>(self, condition: E) -> Self

where E: Expr<'a, PostgresValue<'a>>, E::SQLType: BooleanLike,

Adds a WHERE clause to the conflict target for partial index matching.

Generates: ON CONFLICT (col) WHERE condition DO ...

Note: WHERE is only meaningful for column-based targets, not for ON CONFLICT ON CONSTRAINT targets.

pub fn do_nothing(self) -> InsertBuilder<'a, S, InsertOnConflictSet, T>

Resolves the conflict by doing nothing (ignoring the conflicting row).

Generates: ON CONFLICT (col1, col2) DO NOTHING

pub fn do_update( self, set: impl ToSQL<'a, PostgresValue<'a>>, ) -> InsertBuilder<'a, S, InsertDoUpdateSet, T>

Resolves the conflict by updating the existing row.

The set parameter accepts any ToSQL value, typically an UpdateModel which generates the SET clause assignments. Use EXCLUDED.column to reference the proposed insert values.

Generates: ON CONFLICT (col1, col2) DO UPDATE SET ...

Chain .r#where(condition) to add a conditional update filter.

Trait Implementations

impl<'a, S: Clone, T: Clone> Clone for OnConflictBuilder<'a, S, T>

fn clone(&self) -> OnConflictBuilder<'a, S, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, S: Debug, T: Debug> Debug for OnConflictBuilder<'a, S, T>

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

Formats the value using the given formatter.