Struct DatabaseTransaction 

pub struct DatabaseTransaction { /* private fields */ }

A live database transaction.

Obtain one with TransactionTrait::begin (manual commit/rollback) or TransactionTrait::transaction (auto commit on Ok, auto rollback on Err). Like DatabaseConnection it implements ConnectionTrait, so SeaORM’s query and mutation methods work against it transparently. Calling begin on a transaction starts a nested transaction via SAVEPOINT.

Implementations

impl DatabaseTransaction

pub fn transaction<F, T, E>( &self, callback: F, ) -> Result<T, TransactionError<E>>

where F: for<'c> FnOnce(&'c DatabaseTransaction) -> Result<T, E>, E: Display + Debug,

Execute the function inside a transaction. If the function returns an error, the transaction will be rolled back. Otherwise, the transaction will be committed.

pub fn transaction_with_config<F, T, E>( &self, callback: F, isolation_level: Option<IsolationLevel>, access_mode: Option<AccessMode>, ) -> Result<T, TransactionError<E>>

where F: for<'c> FnOnce(&'c DatabaseTransaction) -> Result<T, E>, E: Display + Debug,

Execute the function inside a transaction with isolation level and/or access mode. If the function returns an error, the transaction will be rolled back. Otherwise, the transaction will be committed.

pub fn commit(self) -> Result<(), DbErr>

Commit a transaction

pub fn rollback(self) -> Result<(), DbErr>

Rolls back a transaction explicitly

Trait Implementations

impl ConnectionTrait for DatabaseTransaction

fn get_database_backend(&self) -> DbBackend

Get the database backend for the connection. This depends on feature flags enabled.

fn execute_raw(&self, stmt: Statement) -> Result<ExecResult, DbErr>

Execute a Statement

fn execute_unprepared(&self, sql: &str) -> Result<ExecResult, DbErr>

Execute a unprepared Statement

fn query_one_raw(&self, stmt: Statement) -> Result<Option<QueryResult>, DbErr>

Execute a Statement and return a single row of QueryResult

fn query_all_raw(&self, stmt: Statement) -> Result<Vec<QueryResult>, DbErr>

Execute a Statement and return a vector of QueryResult

fn execute<S: StatementBuilder>(&self, stmt: &S) -> Result<ExecResult, DbErr>

Execute a StatementBuilder

fn query_one<S: StatementBuilder>( &self, stmt: &S, ) -> Result<Option<QueryResult>, DbErr>

Execute a StatementBuilder and return a single row of QueryResult

fn query_all<S: StatementBuilder>( &self, stmt: &S, ) -> Result<Vec<QueryResult>, DbErr>

Execute a StatementBuilder and return a vector of QueryResult

fn support_returning(&self) -> bool

Check if the connection supports RETURNING syntax on insert and update

fn is_mock_connection(&self) -> bool

Check if the connection is a test connection for the Mock database

impl Debug for DatabaseTransaction

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

Formats the value using the given formatter.

impl Drop for DatabaseTransaction

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<'c> From<&'c DatabaseTransaction> for DatabaseExecutor<'c>

fn from(trans: &'c DatabaseTransaction) -> Self

Converts to this type from the input type.

impl<'c> IntoDatabaseExecutor<'c> for &'c DatabaseTransaction

fn into_database_executor(self) -> DatabaseExecutor<'c>

Build the DatabaseExecutor.

impl IntoDatabaseExecutor<'static> for DatabaseTransaction

fn into_database_executor(self) -> DatabaseExecutor<'static>

Build the DatabaseExecutor.

impl StreamTrait for DatabaseTransaction

Available on crate feature stream only.

type Stream<'a> = TransactionStream<'a>

Create a stream for the QueryResult

fn get_database_backend(&self) -> DbBackend

Get the database backend for the connection. This depends on feature flags enabled.

fn stream_raw<'a>(&'a self, stmt: Statement) -> Result<Self::Stream<'a>, DbErr>

Execute a Statement and return a stream of results

fn stream<'a, S: StatementBuilder>( &'a self, stmt: &S, ) -> Result<Self::Stream<'a>, DbErr>

Execute a StatementBuilder and return a stream of results

impl TransactionSession for DatabaseTransaction

fn commit(self) -> Result<(), DbErr>

Commit a transaction

fn rollback(self) -> Result<(), DbErr>

Rolls back a transaction explicitly

impl TransactionTrait for DatabaseTransaction

fn transaction<F, T, E>(&self, _callback: F) -> Result<T, TransactionError<E>>

where F: for<'c> FnOnce(&'c DatabaseTransaction) -> Result<T, E>, E: Display + Debug,

Execute the function inside a transaction. If the function returns an error, the transaction will be rolled back. Otherwise, the transaction will be committed.

fn transaction_with_config<F, T, E>( &self, _callback: F, isolation_level: Option<IsolationLevel>, access_mode: Option<AccessMode>, ) -> Result<T, TransactionError<E>>

where F: for<'c> FnOnce(&'c DatabaseTransaction) -> Result<T, E>, E: Display + Debug,

Execute the function inside a transaction. If the function returns an error, the transaction will be rolled back. Otherwise, the transaction will be committed.

type Transaction = DatabaseTransaction

The concrete type for the transaction

fn begin(&self) -> Result<DatabaseTransaction, DbErr>

Execute SQL BEGIN transaction. Returns a Transaction that can be committed or rolled back

fn begin_with_config( &self, isolation_level: Option<IsolationLevel>, access_mode: Option<AccessMode>, ) -> Result<DatabaseTransaction, DbErr>

Execute SQL BEGIN transaction with isolation level and/or access mode. Returns a Transaction that can be committed or rolled back

fn begin_with_options( &self, options: TransactionOptions, ) -> Result<DatabaseTransaction, DbErr>

Execute SQL BEGIN transaction with isolation level and/or access mode. Returns a Transaction that can be committed or rolled back