Struct Database 

pub struct Database(/* private fields */);

Handle to a pool of database connections

Executing sql statements is done through the Executor trait which is implemented on &Database.

Common operations are implemented as functions in the database module.

Cloning is cheap i.e. two Arcs.

Implementations

impl Database

pub async fn connect( configuration: DatabaseConfiguration, ) -> Result<Self, Error>

Connects to the database using configuration

pub async fn start_transaction(&self) -> Result<Transaction, Error>

Starts a new transaction

&mut Transaction implements Executor like &Database does but its database operations can be reverted using Transaction::rollback or simply dropping the transaction without calling Transaction::commit.

pub async fn close(self)

Closes the database connection

While calling this method is not strictly necessary, terminating your program without it might result in some final queries not being flushed properly.

This method consumes the database handle, but actually all handles created using clone will become invalid after this call. This means any further operation would result in an Err

Trait Implementations

impl Clone for Database

fn clone(&self) -> Database

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Drop for Database

fn drop(&mut self)

Checks whether Database::close has been called before the last instance is dropped

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.

impl<'executor> Executor<'executor> for &'executor Database

type EnsureTransactionFuture = Pin<Box<dyn Future<Output = Result<TransactionGuard<'executor>, Error>> + Send + 'executor>>

A future producing a TransactionGuard returned by ensure_transaction

fn execute<'data, 'result, Q>( self, query: String, values: Vec<Value<'data>>, ) -> Q::Result<'result>

where Q: QueryStrategy, 'executor: 'result, 'data: 'result,

Executes a raw SQL query

fn into_dyn(self) -> DynamicExecutor<'executor>

Convenience method to convert into a “dyn Executor”

fn dialect(&self) -> DBImpl

Get the executor’s sql dialect.

fn ensure_transaction( self, ) -> Pin<Box<dyn Future<Output = Result<TransactionGuard<'executor>, Error>> + Send + 'executor>>

Ensure a piece of code is run inside a transaction using a TransactionGuard.