Enum TransactionScope 

pub enum TransactionScope {
    ExplicitBorrowed {
        transaction_id: TransactionId,
        read_write: bool,
    },
    AutoCommitOwned {
        transaction_id: TransactionId,
        rollback_only: bool,
    },
    ReadOnlySnapshot {
        transaction_id: TransactionId,
    },
    CommandScope,
    None,
}

The transaction scope for a single query execution.

Pure metadata — no back-reference to the controller. The caller (session / query instance) holds both the scope and the controller separately.

• ExplicitBorrowed: the query runs within a session-level explicit transaction.
• AutoCommitOwned: the instance owns an auto-commit transaction that is committed (or rolled back) when execution completes.
• ReadOnlySnapshot: a read-only snapshot that does not need a write transaction handle.
• CommandScope: transient scope for BEGIN / COMMIT / ROLLBACK state transitions. No real data access happens in this scope.
• None: no transaction is required (DDL, admin commands, etc.).

Variants

ExplicitBorrowed

Fields

transaction_id: TransactionId

read_write: bool

AutoCommitOwned

Fields

transaction_id: TransactionId

rollback_only: bool

ReadOnlySnapshot

Fields

transaction_id: TransactionId

CommandScope

None

Implementations

impl TransactionScope

pub fn explicit(transaction_id: TransactionId, read_write: bool) -> Self

pub fn auto_commit(transaction_id: TransactionId) -> Self

pub fn read_only(transaction_id: TransactionId) -> Self

pub fn allows_write(&self) -> bool

Whether a write operation is allowed in this scope.

pub fn is_explicit(&self) -> bool

Whether this is an explicit (session-level) transaction.

pub fn is_auto_commit(&self) -> bool

Whether this is an auto-commit transaction.

pub fn produces_result(&self) -> bool

Whether this scope expects at least one result row (command scopes do not).

pub fn transaction_id(&self) -> Option<TransactionId>

Return the transaction ID, if any.

pub fn ensure_can_write(&self) -> Result<(), QueryError>

Validate that writes are allowed. Returns an error if this scope forbids writes.

pub fn mark_rollback_only(&mut self)

Mark the transaction as rollback-only (auto-commit variants).

pub fn is_rollback_only(&self) -> bool

Whether the auto-commit transaction has been marked rollback-only.

Trait Implementations

impl Clone for TransactionScope

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TransactionScope

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

Formats the value using the given formatter.