pub struct Transaction<'a> { /* private fields */ }
Expand description

A representation of a PostgreSQL database transaction.

Transactions will implicitly roll back when dropped. Use the commit method to commit the changes made in the transaction. Transactions can be nested, with inner transactions implemented via safepoints.

Implementations§

§

impl<'a> Transaction<'a>

pub async fn commit(self) -> Result<(), Error>

Consumes the transaction, committing all changes made within it.

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

Rolls the transaction back, discarding all changes made within it.

This is equivalent to Transaction’s Drop implementation, but provides any error encountered to the caller.

pub async fn prepare(&self, query: &str) -> Result<Statement, Error>

Like Client::prepare.

pub async fn prepare_typed( &self, query: &str, parameter_types: &[Type] ) -> Result<Statement, Error>

Like Client::prepare_typed.

pub async fn query<T>( &self, statement: &T, params: &[&(dyn ToSql + Sync)] ) -> Result<Vec<Row>, Error>
where T: ToStatement + ?Sized,

Like Client::query.

pub async fn query_one<T>( &self, statement: &T, params: &[&(dyn ToSql + Sync)] ) -> Result<Row, Error>
where T: ToStatement + ?Sized,

Like Client::query_one.

pub async fn query_opt<T>( &self, statement: &T, params: &[&(dyn ToSql + Sync)] ) -> Result<Option<Row>, Error>
where T: ToStatement + ?Sized,

Like Client::query_opt.

pub async fn query_raw<T, P, I>( &self, statement: &T, params: I ) -> Result<RowStream, Error>
where T: ToStatement + ?Sized, P: BorrowToSql, I: IntoIterator<Item = P>, <I as IntoIterator>::IntoIter: ExactSizeIterator,

Like Client::query_raw.

pub async fn execute<T>( &self, statement: &T, params: &[&(dyn ToSql + Sync)] ) -> Result<u64, Error>
where T: ToStatement + ?Sized,

Like Client::execute.

pub async fn execute_raw<P, I, T>( &self, statement: &T, params: I ) -> Result<u64, Error>
where T: ToStatement + ?Sized, P: BorrowToSql, I: IntoIterator<Item = P>, <I as IntoIterator>::IntoIter: ExactSizeIterator,

Like Client::execute_iter.

pub async fn bind<T>( &self, statement: &T, params: &[&(dyn ToSql + Sync)] ) -> Result<Portal, Error>
where T: ToStatement + ?Sized,

Binds a statement to a set of parameters, creating a Portal which can be incrementally queried.

Portals only last for the duration of the transaction in which they are created, and can only be used on the connection that created them.

Panics

Panics if the number of parameters provided does not match the number expected.

pub async fn bind_raw<P, T, I>( &self, statement: &T, params: I ) -> Result<Portal, Error>
where T: ToStatement + ?Sized, P: BorrowToSql, I: IntoIterator<Item = P>, <I as IntoIterator>::IntoIter: ExactSizeIterator,

A maximally flexible version of bind.

pub async fn query_portal( &self, portal: &Portal, max_rows: i32 ) -> Result<Vec<Row>, Error>

Continues execution of a portal, returning a stream of the resulting rows.

Unlike query, portals can be incrementally evaluated by limiting the number of rows returned in each call to query_portal. If the requested number is negative or 0, all rows will be returned.

pub async fn query_portal_raw( &self, portal: &Portal, max_rows: i32 ) -> Result<RowStream, Error>

The maximally flexible version of query_portal.

pub async fn copy_in<T, U>(&self, statement: &T) -> Result<CopyInSink<U>, Error>
where T: ToStatement + ?Sized, U: Buf + 'static + Send,

Like Client::copy_in.

pub async fn copy_out<T>(&self, statement: &T) -> Result<CopyOutStream, Error>
where T: ToStatement + ?Sized,

Like Client::copy_out.

pub async fn simple_query( &self, query: &str ) -> Result<Vec<SimpleQueryMessage>, Error>

Like Client::simple_query.

pub async fn batch_execute(&self, query: &str) -> Result<(), Error>

Like Client::batch_execute.

pub fn cancel_token(&self) -> CancelToken

Like Client::cancel_token.

pub async fn cancel_query<T>(&self, tls: T) -> Result<(), Error>
where T: MakeTlsConnect<Socket>,

👎Deprecated since 0.6.0: use Transaction::cancel_token() instead

Like Client::cancel_query.

pub async fn cancel_query_raw<S, T>( &self, stream: S, tls: T ) -> Result<(), Error>
where S: AsyncRead + AsyncWrite + Unpin, T: TlsConnect<S>,

👎Deprecated since 0.6.0: use Transaction::cancel_token() instead

Like Client::cancel_query_raw.

pub async fn transaction(&mut self) -> Result<Transaction<'_>, Error>

Like Client::transaction, but creates a nested transaction via a savepoint.

pub async fn savepoint<I>(&mut self, name: I) -> Result<Transaction<'_>, Error>
where I: Into<String>,

Like Client::transaction, but creates a nested transaction via a savepoint with the specified name.

pub fn client(&self) -> &Client

Returns a reference to the underlying Client.

Trait Implementations§

§

impl<'a> Drop for Transaction<'a>

§

fn drop(&mut self)

Executes the destructor for this type. Read more
§

impl GenericClient for Transaction<'_>

§

fn execute<'life0, 'life1, 'life2, 'life3, 'async_trait, T>( &'life0 self, query: &'life1 T, params: &'life2 [&'life3 (dyn ToSql + Sync)] ) -> Pin<Box<dyn Future<Output = Result<u64, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, T: ToStatement + Sync + Send + 'async_trait + ?Sized, Transaction<'_>: 'async_trait,

Like Client::execute.
§

fn execute_raw<'life0, 'life1, 'async_trait, P, I, T>( &'life0 self, statement: &'life1 T, params: I ) -> Pin<Box<dyn Future<Output = Result<u64, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, T: ToStatement + Sync + Send + 'async_trait + ?Sized, P: BorrowToSql + 'async_trait, I: IntoIterator<Item = P> + Sync + Send + 'async_trait, <I as IntoIterator>::IntoIter: ExactSizeIterator, Transaction<'_>: 'async_trait,

Like Client::execute_raw.
§

fn query<'life0, 'life1, 'life2, 'life3, 'async_trait, T>( &'life0 self, query: &'life1 T, params: &'life2 [&'life3 (dyn ToSql + Sync)] ) -> Pin<Box<dyn Future<Output = Result<Vec<Row>, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, T: ToStatement + Sync + Send + 'async_trait + ?Sized, Transaction<'_>: 'async_trait,

Like Client::query.
§

fn query_one<'life0, 'life1, 'life2, 'life3, 'async_trait, T>( &'life0 self, statement: &'life1 T, params: &'life2 [&'life3 (dyn ToSql + Sync)] ) -> Pin<Box<dyn Future<Output = Result<Row, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, T: ToStatement + Sync + Send + 'async_trait + ?Sized, Transaction<'_>: 'async_trait,

Like Client::query_one.
§

fn query_opt<'life0, 'life1, 'life2, 'life3, 'async_trait, T>( &'life0 self, statement: &'life1 T, params: &'life2 [&'life3 (dyn ToSql + Sync)] ) -> Pin<Box<dyn Future<Output = Result<Option<Row>, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, T: ToStatement + Sync + Send + 'async_trait + ?Sized, Transaction<'_>: 'async_trait,

Like Client::query_opt.
§

fn query_raw<'life0, 'life1, 'async_trait, T, P, I>( &'life0 self, statement: &'life1 T, params: I ) -> Pin<Box<dyn Future<Output = Result<RowStream, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, T: ToStatement + Sync + Send + 'async_trait + ?Sized, P: BorrowToSql + 'async_trait, I: IntoIterator<Item = P> + Sync + Send + 'async_trait, <I as IntoIterator>::IntoIter: ExactSizeIterator, Transaction<'_>: 'async_trait,

Like Client::query_raw.
§

fn prepare<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 str ) -> Pin<Box<dyn Future<Output = Result<Statement, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, Transaction<'_>: 'async_trait,

Like Client::prepare.
§

fn prepare_typed<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, query: &'life1 str, parameter_types: &'life2 [Type] ) -> Pin<Box<dyn Future<Output = Result<Statement, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, Transaction<'_>: 'async_trait,

Like Client::prepare_typed.
§

fn transaction<'a, 'async_trait>( &'a mut self ) -> Pin<Box<dyn Future<Output = Result<Transaction<'a>, Error>> + Send + 'async_trait>>
where 'a: 'async_trait, Transaction<'_>: 'async_trait,

Like Client::transaction.
§

fn batch_execute<'life0, 'life1, 'async_trait>( &'life0 self, query: &'life1 str ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, 'life1: 'async_trait, Transaction<'_>: 'async_trait,

Like Client::batch_execute.
§

fn client(&self) -> &Client

Returns a reference to the underlying Client.

Auto Trait Implementations§

§

impl<'a> !RefUnwindSafe for Transaction<'a>

§

impl<'a> Send for Transaction<'a>

§

impl<'a> Sync for Transaction<'a>

§

impl<'a> Unpin for Transaction<'a>

§

impl<'a> !UnwindSafe for Transaction<'a>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> Same for T

§

type Output = T

Should always be Self
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more