Trait RelationalBackend 

pub trait RelationalBackend: Send + Sync {
    type Tx<'a>: RelationalTx + 'a
       where Self: 'a;

    // Required methods
    fn backend(&self) -> &str;
    fn version(&self) -> &str;
    fn dialect(&self) -> Dialect;
    fn execute(
        &self,
        sql: &str,
        params: &[Value],
    ) -> impl Future<Output = Result<u64, RelError>> + Send;
    fn query(
        &self,
        sql: &str,
        params: &[Value],
    ) -> impl Future<Output = Result<Vec<Row>, RelError>> + Send;
    fn begin(
        &self,
        isolation: Isolation,
    ) -> impl Future<Output = Result<Self::Tx<'_>, RelError>> + Send;
}

A relational database, as small as it can be.

Statements are written in the backend’s own Dialect; parameters are positional and written as that dialect writes them ($1 for PostgreSQL). Nothing here translates SQL.

Required Associated Types

type Tx<'a>: RelationalTx + 'a where Self: 'a

A transaction on this backend. Dropping it without commit rolls it back.

Required Methods

fn backend(&self) -> &str

The backend’s name as it appears in matrix rows (postgres).

fn version(&self) -> &str

The server version string as it appears in matrix rows (16.15).

fn dialect(&self) -> Dialect

The dialect statements must be written in.

fn execute( &self, sql: &str, params: &[Value], ) -> impl Future<Output = Result<u64, RelError>> + Send

Run a statement that returns no rows; the result is the number of rows affected.

fn query( &self, sql: &str, params: &[Value], ) -> impl Future<Output = Result<Vec<Row>, RelError>> + Send

Run a statement and return its rows.

fn begin( &self, isolation: Isolation, ) -> impl Future<Output = Result<Self::Tx<'_>, RelError>> + Send

Begin a transaction at (at least) isolation.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl<R: RelationalBackend> RelationalBackend for Defective<'_, R>

type Tx<'a> = DefectiveTx<'a, R> where Self: 'a