Struct Transaction 

pub struct Transaction { /* private fields */ }

Wraps statements in a SurrealDB transaction — BEGIN TRANSACTION; … ; COMMIT TRANSACTION;. Either every statement applies or none do: SurrealDB rolls the whole block back if any statement errors, and cancel terminates with CANCEL TRANSACTION to roll back explicitly. Unlike Batch (a plain ;-joined sequence), a transaction is atomic.

Push already-rendered statements (to_surrealql() output); each is ;-terminated automatically.

Implementations

impl Transaction

pub fn new() -> Self

pub fn push(self, stmt: impl ToString) -> Self

Add a statement to the transaction body.

pub fn cancel(self) -> Self

Terminate with CANCEL TRANSACTION (roll back) instead of COMMIT.

pub fn to_surrealql(&self) -> String

pub fn len(&self) -> usize

Number of statements in the transaction body (excludes BEGIN/COMMIT).

pub fn is_empty(&self) -> bool

Trait Implementations

impl Default for Transaction

fn default() -> Transaction

Returns the “default value” for a type.

impl Display for Transaction

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

Formats the value using the given formatter.