Struct TryInsert

pub struct TryInsert<A>
where
    A: ActiveModelTrait,
{ /* private fields */ }

Performs INSERT operations on a ActiveModel, will do nothing if input is empty.

All functions works the same as if it is Insert. Please refer to Insert page for more information

Implementations

impl<A> TryInsert<A>

where A: ActiveModelTrait,

pub async fn exec<'a, C>( self, db: &'a C, ) -> Result<TryInsertResult<InsertResult<A>>, DbErr>

where C: ConnectionTrait, A: 'a,

Execute an insert operation

pub async fn exec_without_returning<'a, C>( self, db: &'a C, ) -> Result<TryInsertResult<u64>, DbErr>

where <<A as ActiveModelTrait>::Entity as EntityTrait>::Model: IntoActiveModel<A>, C: ConnectionTrait, A: 'a,

Execute an insert operation without returning (don’t use RETURNING syntax) Number of rows affected is returned

pub async fn exec_with_returning<'a, C>( self, db: &'a C, ) -> Result<TryInsertResult<<<A as ActiveModelTrait>::Entity as EntityTrait>::Model>, DbErr>

where <<A as ActiveModelTrait>::Entity as EntityTrait>::Model: IntoActiveModel<A>, C: ConnectionTrait, A: 'a,

Execute an insert operation and return the inserted model (use RETURNING syntax if supported)

pub async fn exec_with_returning_keys<'a, C>( self, db: &'a C, ) -> Result<TryInsertResult<Vec<<<<A as ActiveModelTrait>::Entity as EntityTrait>::PrimaryKey as PrimaryKeyTrait>::ValueType>>, DbErr>

where <<A as ActiveModelTrait>::Entity as EntityTrait>::Model: IntoActiveModel<A>, C: ConnectionTrait, A: 'a,

Execute an insert operation and return primary keys of inserted models

Panics

Panics if the database backend does not support INSERT RETURNING.

pub async fn exec_with_returning_many<'a, C>( self, db: &'a C, ) -> Result<TryInsertResult<Vec<<<A as ActiveModelTrait>::Entity as EntityTrait>::Model>>, DbErr>

where <<A as ActiveModelTrait>::Entity as EntityTrait>::Model: IntoActiveModel<A>, C: ConnectionTrait, A: 'a,

Execute an insert operation and return all inserted models

Panics

Panics if the database backend does not support INSERT RETURNING.

impl<A> TryInsert<A>

where A: ActiveModelTrait,

pub fn one<M>(m: M) -> TryInsert<A>

where M: IntoActiveModel<A>,

pub fn many<M, I>(models: I) -> TryInsert<A>

where M: IntoActiveModel<A>, I: IntoIterator<Item = M>,

pub fn add<M>(self, m: M) -> TryInsert<A>

where M: IntoActiveModel<A>,

pub fn add_many<M, I>(self, models: I) -> TryInsert<A>

where M: IntoActiveModel<A>, I: IntoIterator<Item = M>,

pub fn on_conflict(self, on_conflict: OnConflict) -> TryInsert<A>

pub fn from_insert(insert: Insert<A>) -> TryInsert<A>

Trait Implementations

impl<A> Debug for TryInsert<A>

where A: Debug + ActiveModelTrait,

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

Formats the value using the given formatter.

impl<A> Default for TryInsert<A>

where A: ActiveModelTrait,

fn default() -> TryInsert<A>

Returns the “default value” for a type.

impl<A> QueryTrait for TryInsert<A>

where A: ActiveModelTrait,

type QueryStatement = InsertStatement

Constrain the QueryStatement to QueryStatementBuilder trait

fn query(&mut self) -> &mut InsertStatement

Get a mutable ref to the query builder

fn as_query(&self) -> &InsertStatement

Get an immutable ref to the query builder

fn into_query(self) -> InsertStatement

Take ownership of the query builder

fn build(&self, db_backend: DatabaseBackend) -> Statement

Build the query as Statement

fn apply_if<T, F>(self, val: Option<T>, if_some: F) -> Self

where Self: Sized, F: FnOnce(Self, T) -> Self,

Apply an operation on the QueryTrait::QueryStatement if the given Option<T> is Some(_)