Struct Insert 

pub struct Insert<A: ActiveModelTrait> { /* private fields */ }

An INSERT of one active model.

Implementations

impl<A: ActiveModelTrait> Insert<A>

pub fn on_conflict(self, on_conflict: OnConflict) -> Self

Sets the ON CONFLICT clause.

pub fn build(&self) -> Statement

Renders the statement without RETURNING.

pub async fn exec<C: ConnectionTrait>( self, db: &C, ) -> Result<InsertResult<A::Entity>>

Executes the insert and returns the primary key.

A key the caller supplied is echoed back; a generated one is read from last_insert_rowid(). Non-integer keys cannot be reconstructed this way, so use exec_with_returning for them.

Errors

Returns DbErr::RecordNotInserted when the statement inserted nothing, for example under ON CONFLICT DO NOTHING; DbErr::Type when the key is not an integer or does not fit the key type; DbErr::Driver when the statement fails.

pub async fn exec_with_returning<C: ConnectionTrait>( self, db: &C, ) -> Result<<A::Entity as EntityTrait>::Model>

Executes the insert with RETURNING * and returns the stored model.

Errors

Returns DbErr::RecordNotInserted when the statement inserted nothing; DbErr::Driver when the statement fails or the returned row cannot be decoded.

Trait Implementations

impl<A: Clone + ActiveModelTrait> Clone for Insert<A>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<A: Debug + ActiveModelTrait> Debug for Insert<A>

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

Formats the value using the given formatter.