Struct Upsert 

pub struct Upsert {
    pub stmt: Insert,
    pub params: Vec<TypedValue>,
    pub ret: Option<Vec<Type>>,
}

Executes a lowered single-row upsert on a non-SQL database driver.

The query engine emits this operation only after verifying the requested target and branch behavior against Capability. stmt contains one values row and an stmt::Upsert clause whose target has been lowered from model fields to database columns. Shared mutations retain their model-declared field defaults so the driver can apply the same value when it creates an item.

A driver must perform the conflict check and the create, update, or ignore action atomically. It must not implement this operation as a read followed by a separate insert or update. An update action returns the stored row. An ignore action returns one row after an insert and zero rows after the selected target conflicts.

Examples

use toasty_core::driver::operation::{Operation, Upsert};

let op = Upsert {
    stmt: lowered_insert,
    params: typed_params,
    ret: Some(return_types),
};
let operation: Operation = op.into();

Fields

stmt: Insert

The lowered insert statement carrying the conflict target and action.

Literal bind values are replaced with Expr::Arg(n), where n indexes params. The statement’s upsert field is always Some, and its target is UpsertTarget::Columns.

params: Vec<TypedValue>

Typed bind parameters extracted from stmt.

ret: Option<Vec<Type>>

Types of the columns returned by the operation, in projection order.

Some(types) requires the driver to return the stored row projected to these types. None requires no returned row.

Trait Implementations

impl Clone for Upsert

fn clone(&self) -> Upsert

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Upsert

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

Formats the value using the given formatter.

impl From<Upsert> for Operation

fn from(value: Upsert) -> Self

Converts to this type from the input type.