Struct qldb::Transaction

pub struct Transaction { /* private fields */ }

Every query in QLDB is within a transaction. Ideally you will interact with this object via the method QLDBClient::transaction_within.

Implementations

impl Transaction

pub fn query(&self, statement: &str) -> QueryBuilder

Sends a query to QLDB. It will return an Array of IonValues already decoded. Parameters need to be provided using IonValue.

pub async fn commit(&self) -> QldbResult<()>

pub async fn rollback(&self) -> QldbResult<()>

Cancels the transaction. Once rollback is called the transaction becomes invalid. Subsequent calls to rollback or commit (internally) won’t have any effect.

It fails is the transaction is already committed. For a rollback that doesn’t fail when already committed you can check the silent_rollback method.

pub async fn silent_rollback(&self) -> QldbResult<()>

Cancels the transaction but it doesn’t fails is the transaction was already committed. This is useful for auto-closing scenarios where you just want to rollback always when there is a drop or something similar.

Once rollback is called the transaction becomes invalid. Subsequent calls to rollback or commit (internally) won’t have any effect.

Trait Implementations

impl Clone for Transaction

fn clone(&self) -> Transaction

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Transaction

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

Formats the value using the given formatter.