Struct Savepoint 

#[non_exhaustive]
pub struct Savepoint<'t, 'c> { /* private fields */ }

A savepoint within an active transaction.

Created via Transaction::savepoint. The savepoint acts as a sub-transaction: it can be released (committed) or rolled back independently of the outer transaction.

Drop behaviour

If the savepoint is not explicitly released or rolled back before it goes out of scope, Drop cannot perform async I/O. Users should always call release or rollback explicitly.

Implementations

impl<'t, 'c> Savepoint<'t, 'c>

pub async fn release(self) -> Result<()>

Release the savepoint (like a commit for the nested scope).

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

Roll back to the savepoint.

pub async fn query(&mut self, sql: &str) -> Result<QueryResult>

Execute a query that returns rows, within the savepoint scope.

pub async fn execute(&mut self, sql: &str) -> Result<ExecuteResult>

Execute a statement that does not return rows.

pub async fn query_params( &mut self, sql: &str, params: &[&dyn ToSql], ) -> Result<QueryResult>

Execute a parameterized query that returns rows.

pub async fn execute_params( &mut self, sql: &str, params: &[&dyn ToSql], ) -> Result<ExecuteResult>

Execute a parameterized statement that does not return rows.

pub async fn prepare(&mut self, sql: &str) -> Result<PreparedStatement>

Prepare a statement within the savepoint scope.

Trait Implementations

impl<'t, 'c> Drop for Savepoint<'t, 'c>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.