Struct InsertStatement 

pub struct InsertStatement {
    pub table: String,
    pub columns: Option<Vec<String>>,
    pub rows: Vec<Vec<Expr>>,
    pub select_source: Option<Box<SelectStatement>>,
    pub on_conflict: Option<OnConflictClause>,
    pub returning: Option<Vec<SelectItem>>,
}

Fields

table: String

columns: Option<Vec<String>>

Optional column list — INSERT INTO t (a, b) VALUES (...). When None, every tuple is positional and must match the table arity. When Some, the engine maps each tuple slot to the named column and fills the rest with NULL (must be nullable).

rows: Vec<Vec<Expr>>

One or more (expr, expr, ...) tuples — the multi-row VALUES form. v1.3+ accepts INSERT INTO t VALUES (a), (b). Empty when select_source is Some (the engine builds rows from the inner SELECT result set instead).

select_source: Option<Box<SelectStatement>>

v7.13.0 — INSERT INTO t [(cols)] SELECT … (mailrs round-5 G4). When present, rows is empty and the engine materialises the SELECT result, coerces each output tuple to the target column types, and inserts as a single batch.

on_conflict: Option<OnConflictClause>

v7.9.7 — ON CONFLICT (cols) DO { NOTHING | UPDATE SET … } upsert clause. None = legacy INSERT (conflict raises a DuplicateKey error). mailrs migration blocker #2.

returning: Option<Vec<SelectItem>>

v7.9.4 — RETURNING <projection>.

Trait Implementations

impl Clone for InsertStatement

fn clone(&self) -> InsertStatement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InsertStatement

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

Formats the value using the given formatter.

impl Display for InsertStatement

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

Formats the value using the given formatter.

impl PartialEq for InsertStatement

fn eq(&self, other: &InsertStatement) -> 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 InsertStatement