pub struct Insert<A>where
    A: ActiveModelTrait,{ /* private fields */ }
Expand description

Performs INSERT operations on a ActiveModel

Implementations§

source§

impl<A> Insert<A>where A: ActiveModelTrait,

source

pub fn exec<'a, C>( self, db: &'a C ) -> impl Future<Output = Result<InsertResult<A>, DbErr>> + 'awhere C: ConnectionTrait, A: 'a,

Execute an insert operation

source

pub fn exec_without_returning<'a, C>( self, db: &'a C ) -> impl Future<Output = Result<u64, DbErr>> + 'awhere <<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

source

pub fn exec_with_returning<'a, C>( self, db: &'a C ) -> impl Future<Output = Result<<<A as ActiveModelTrait>::Entity as EntityTrait>::Model, DbErr>> + 'awhere <<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 database supported)

source§

impl<A> Insert<A>where A: ActiveModelTrait,

source

pub fn one<M>(m: M) -> Insert<A>where M: IntoActiveModel<A>,

Insert one Model or ActiveModel

Model

use sea_orm::{entity::*, query::*, tests_cfg::cake, DbBackend};

assert_eq!(
    Insert::one(cake::Model {
        id: 1,
        name: "Apple Pie".to_owned(),
    })
    .build(DbBackend::Postgres)
    .to_string(),
    r#"INSERT INTO "cake" ("id", "name") VALUES (1, 'Apple Pie')"#,
);

ActiveModel

use sea_orm::{entity::*, query::*, tests_cfg::cake, DbBackend};

assert_eq!(
    Insert::one(cake::ActiveModel {
        id: NotSet,
        name: Set("Apple Pie".to_owned()),
    })
    .build(DbBackend::Postgres)
    .to_string(),
    r#"INSERT INTO "cake" ("name") VALUES ('Apple Pie')"#,
);
source

pub fn many<M, I>(models: I) -> Insert<A>where M: IntoActiveModel<A>, I: IntoIterator<Item = M>,

Insert many Model or ActiveModel

use sea_orm::{entity::*, query::*, tests_cfg::cake, DbBackend};

assert_eq!(
    Insert::many([
        cake::Model {
            id: 1,
            name: "Apple Pie".to_owned(),
        },
        cake::Model {
            id: 2,
            name: "Orange Scone".to_owned(),
        }
    ])
    .build(DbBackend::Postgres)
    .to_string(),
    r#"INSERT INTO "cake" ("id", "name") VALUES (1, 'Apple Pie'), (2, 'Orange Scone')"#,
);
source

pub fn add<M>(self, m: M) -> Insert<A>where M: IntoActiveModel<A>,

Add a Model to Self

Panics

Panics if the column value has discrepancy across rows

source

pub fn add_many<M, I>(self, models: I) -> Insert<A>where M: IntoActiveModel<A>, I: IntoIterator<Item = M>,

Add many Models to Self

source

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

On conflict

on conflict do nothing

use sea_orm::{entity::*, query::*, sea_query::OnConflict, tests_cfg::cake, DbBackend};

let orange = cake::ActiveModel {
    id: ActiveValue::set(2),
    name: ActiveValue::set("Orange".to_owned()),
};
assert_eq!(
    cake::Entity::insert(orange)
        .on_conflict(
            OnConflict::column(cake::Column::Name)
                .do_nothing()
                .to_owned()
        )
        .build(DbBackend::Postgres)
        .to_string(),
    r#"INSERT INTO "cake" ("id", "name") VALUES (2, 'Orange') ON CONFLICT ("name") DO NOTHING"#,
);

on conflict do update

use sea_orm::{entity::*, query::*, sea_query::OnConflict, tests_cfg::cake, DbBackend};

let orange = cake::ActiveModel {
    id: ActiveValue::set(2),
    name: ActiveValue::set("Orange".to_owned()),
};
assert_eq!(
    cake::Entity::insert(orange)
        .on_conflict(
            OnConflict::column(cake::Column::Name)
                .update_column(cake::Column::Name)
                .to_owned()
        )
        .build(DbBackend::Postgres)
        .to_string(),
    r#"INSERT INTO "cake" ("id", "name") VALUES (2, 'Orange') ON CONFLICT ("name") DO UPDATE SET "name" = "excluded"."name""#,
);

Trait Implementations§

source§

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

source§

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

Formats the value using the given formatter. Read more
source§

impl<A> Default for Insert<A>where A: ActiveModelTrait,

source§

fn default() -> Insert<A>

Returns the “default value” for a type. Read more
source§

impl<A> QueryTrait for Insert<A>where A: ActiveModelTrait,

§

type QueryStatement = InsertStatement

Constrain the QueryStatement to QueryStatementBuilder trait
source§

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

Get a mutable ref to the query builder
source§

fn as_query(&self) -> &InsertStatement

Get an immutable ref to the query builder
source§

fn into_query(self) -> InsertStatement

Take ownership of the query builder
source§

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

Build the query as Statement
source§

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

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

Auto Trait Implementations§

§

impl<A> !RefUnwindSafe for Insert<A>

§

impl<A> Send for Insert<A>where A: Send,

§

impl<A> Sync for Insert<A>where A: Sync,

§

impl<A> Unpin for Insert<A>where A: Unpin,

§

impl<A> !UnwindSafe for Insert<A>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pointable for T

§

const ALIGN: usize = mem::align_of::<T>()

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more