Struct Transaction 

pub struct Transaction<'conn> { /* private fields */ }

A database transaction (concrete implementation).

Transactions provide ACID guarantees and can be committed or rolled back. If dropped without committing, the transaction is automatically rolled back.

This is a concrete type used by the default transaction implementation. Driver-specific implementations may use their own types that implement TransactionOps.

Implementations

impl<'conn> Transaction<'conn>

pub fn new(conn: &'conn dyn TransactionInternal) -> Self

Create a new transaction wrapper.

This is typically called by the driver, not by users directly.

pub const fn is_finalized(&self) -> bool

Check if this transaction has been finalized.

Trait Implementations

impl Drop for Transaction<'_>

fn drop(&mut self)

Executes the destructor for this type.

impl TransactionOps for Transaction<'_>

fn query( &self, cx: &Cx, sql: &str, params: &[Value], ) -> impl Future<Output = Outcome<Vec<Row>, Error>> + Send

Execute a query within this transaction.

fn query_one( &self, cx: &Cx, sql: &str, params: &[Value], ) -> impl Future<Output = Outcome<Option<Row>, Error>> + Send

Execute a query and return the first row, if any.

fn execute( &self, cx: &Cx, sql: &str, params: &[Value], ) -> impl Future<Output = Outcome<u64, Error>> + Send

Execute a statement within this transaction.

fn savepoint( &self, cx: &Cx, name: &str, ) -> impl Future<Output = Outcome<(), Error>> + Send

Create a savepoint within this transaction.

fn rollback_to( &self, cx: &Cx, name: &str, ) -> impl Future<Output = Outcome<(), Error>> + Send

Rollback to a previously created savepoint.

fn release( &self, cx: &Cx, name: &str, ) -> impl Future<Output = Outcome<(), Error>> + Send

Release a savepoint, making the changes permanent within the transaction.

async fn commit(self, cx: &Cx) -> Outcome<(), Error>

Commit the transaction, making all changes permanent.

async fn rollback(self, cx: &Cx) -> Outcome<(), Error>

Rollback the transaction, discarding all changes.