Struct DbReadConnection 

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

Read pool. Multi-connection; concurrent reads enabled by WAL mode.

ConnectionTrait is implemented so SELECTs work transparently. Writes also technically execute (sea-orm has no read-only enforcement at the trait level), but doing so via this type defeats the purpose — write paths must take a DbWriteConnection argument.

Clone is cheap: the inner DatabaseConnection holds an Arc over the underlying sqlx pool, so clones share connection state.

Implementations

impl DbReadConnection

pub fn new(inner: DatabaseConnection) -> Self

Wrap a sea-orm connection as a read pool.

pub async fn open( db_path: &Path, max_connections: u32, connect_timeout: Duration, busy_timeout: Duration, ) -> Result<Self, Error>

Open a stand-alone read pool at db_path with shared PRAGMAs.

Read-only: opening a non-existent DB fails rather than creating it, so a read consumer never authors or pre-empts the catalog owned by msb.

pub async fn open_read_only( db_path: &Path, connect_timeout: Duration, busy_timeout: Duration, ) -> Result<Self, Error>

Open an existing catalog without creating it or changing its journal mode.

Intended for short control lookups after the caller coordinates with migrations. This is a normal WAL-aware reader, never an immutable-file shortcut.

pub fn inner(&self) -> &DatabaseConnection

Borrow the underlying sea-orm connection.

Trait Implementations

impl Clone for DbReadConnection

fn clone(&self) -> DbReadConnection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConnectionTrait for DbReadConnection

fn get_database_backend(&self) -> DbBackend

Get the database backend for the connection. This depends on feature flags enabled.

fn execute_raw<'life0, 'async_trait>( &'life0 self, stmt: Statement, ) -> Pin<Box<dyn Future<Output = Result<ExecResult, DbErr>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute a Statement

fn execute_unprepared<'life0, 'life1, 'async_trait>( &'life0 self, sql: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<ExecResult, DbErr>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Execute a unprepared Statement

fn query_one_raw<'life0, 'async_trait>( &'life0 self, stmt: Statement, ) -> Pin<Box<dyn Future<Output = Result<Option<QueryResult>, DbErr>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute a Statement and return a single row of QueryResult

fn query_all_raw<'life0, 'async_trait>( &'life0 self, stmt: Statement, ) -> Pin<Box<dyn Future<Output = Result<Vec<QueryResult>, DbErr>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute a Statement and return a vector of QueryResult

fn support_returning(&self) -> bool

Check if the connection supports RETURNING syntax on insert and update

fn is_mock_connection(&self) -> bool

Check if the connection is a test connection for the Mock database

fn execute<'life0, 'life1, 'async_trait, S>( &'life0 self, stmt: &'life1 S, ) -> Pin<Box<dyn Future<Output = Result<ExecResult, DbErr>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, S: 'async_trait + StatementBuilder, Self: 'async_trait,

Execute a StatementBuilder

fn query_one<'life0, 'life1, 'async_trait, S>( &'life0 self, stmt: &'life1 S, ) -> Pin<Box<dyn Future<Output = Result<Option<QueryResult>, DbErr>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, S: 'async_trait + StatementBuilder, Self: 'async_trait,

Execute a StatementBuilder and return a single row of QueryResult

fn query_all<'life0, 'life1, 'async_trait, S>( &'life0 self, stmt: &'life1 S, ) -> Pin<Box<dyn Future<Output = Result<Vec<QueryResult>, DbErr>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, S: 'async_trait + StatementBuilder, Self: 'async_trait,

Execute a StatementBuilder and return a vector of QueryResult

impl Debug for DbReadConnection

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

Formats the value using the given formatter.