Struct Transaction 

pub struct Transaction { /* private fields */ }

An active database transaction, typed by backend.

Transaction wraps either a sqlx::Transaction<'static, sqlx::Sqlite> or a sqlx::Transaction<'static, sqlx::Postgres> and provides the executor surface needed by the ORM’s query terminals.

How to obtain one

The typical path is through the top-level closure helpers:

use umbral::db::transaction;

let order = transaction(|tx| async move {
    let o = Order::objects().on_tx(tx).create(new_order).await?;
    Inventory::objects().on_tx(tx).filter(...).update_values(...).await?;
    Ok::<_, MyError>(o)
}).await?;

For manual control (committing or rolling back yourself) call begin / begin_sqlite / begin_pg directly.

Executor contract

The as_sqlite_mut / as_pg_mut accessors return a mutable reference to the underlying sqlx transaction so ORM internals can call sqlx::query(...).execute(&mut *inner). Both the QuerySet::on_tx and Manager::create_in_tx methods receive &mut Transaction and dispatch through these accessors.

Implementations

impl Transaction

pub fn as_sqlite_mut(&mut self) -> Option<&mut Transaction<'static, Sqlite>>

Return a mutable reference to the inner SQLite transaction, or None when this is a Postgres transaction.

pub fn as_pg_mut(&mut self) -> Option<&mut Transaction<'static, Postgres>>

Return a mutable reference to the inner Postgres transaction, or None when this is a SQLite transaction.

pub fn backend_name(&self) -> &'static str

The backend name — "sqlite" or "postgres". Mirrors DbPool::backend_name so shared dispatch helpers can use the same match arm.

pub async fn commit(self) -> Result<(), Error>

Commit the transaction explicitly.

The closure-based helpers (transaction / transaction_sqlite / transaction_pg) call this automatically on Ok. Use this only when you obtained the transaction via begin / begin_sqlite / begin_pg and are driving the lifecycle yourself.

pub async fn rollback(self) -> Result<(), Error>

Roll back the transaction explicitly.

The closure-based helpers call this automatically on Err. Use this only in the manual-control pattern.