Struct OdbcConnection 

pub struct OdbcConnection { /* private fields */ }

Available on crate feature odbc only.

A connection to an ODBC-accessible database.

ODBC uses a blocking C API, so we offload blocking calls to the runtime’s blocking thread-pool via spawn_blocking and synchronize access with a mutex.

Implementations

impl OdbcConnection

pub async fn prepare<'a>( &mut self, sql: &'a str, ) -> Result<OdbcStatement<'a>, Error>

Trait Implementations

impl<'c> Acquire<'c> for &'c mut OdbcConnection

type Database = Odbc

type Connection = &'c mut <Odbc as Database>::Connection

fn acquire(self) -> BoxFuture<'c, Result<Self::Connection, Error>>

fn begin(self) -> BoxFuture<'c, Result<Transaction<'c, Odbc>, Error>>

impl Connection for OdbcConnection

type Database = Odbc

type Options = OdbcConnectOptions

fn close(self) -> BoxFuture<'static, Result<(), Error>>

Explicitly close this database connection.

fn ping(&mut self) -> BoxFuture<'_, Result<(), Error>>

Checks if a connection to the database is still valid.

fn begin( &mut self, ) -> BoxFuture<'_, Result<Transaction<'_, Self::Database>, Error>>

where Self: Sized,

Begin a new transaction or establish a savepoint within the active transaction.

fn clear_cached_statements(&mut self) -> BoxFuture<'_, Result<(), Error>>

Removes all statements from the cache, closing them on the server if needed.

fn dbms_name(&mut self) -> BoxFuture<'_, Result<String, Error>>

Returns the name of the Database Management System (DBMS) this connection is talking to.

fn transaction<'a, F, R, E>( &'a mut self, callback: F, ) -> BoxFuture<'a, Result<R, E>>

where for<'c> F: FnOnce(&'c mut Transaction<'_, Self::Database>) -> BoxFuture<'c, Result<R, E>> + 'a + Send + Sync, Self: Sized, R: Send, E: From<Error> + Send,

Execute the function inside a transaction.

fn cached_statements_size(&self) -> usize

where Self::Database: HasStatementCache,

The number of statements currently cached in the connection.

fn connect(url: &str) -> BoxFuture<'static, Result<Self, Error>>

where Self: Sized,

Establish a new database connection.

fn connect_with(options: &Self::Options) -> BoxFuture<'_, Result<Self, Error>>

where Self: Sized,

Establish a new database connection with the provided options.

impl Debug for OdbcConnection

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

Formats the value using the given formatter.

impl<'c> Executor<'c> for &'c mut OdbcConnection

type Database = Odbc

fn fetch_many<'e, 'q: 'e, E>( self, query: E, ) -> BoxStream<'e, Result<Either<OdbcQueryResult, OdbcRow>, Error>>

where E: Execute<'q, Self::Database> + 'q, 'c: 'e,

Execute multiple queries and return the generated results as a stream from each query, in a stream.

fn fetch_optional<'e, 'q: 'e, E>( self, query: E, ) -> BoxFuture<'e, Result<Option<OdbcRow>, Error>>

where E: Execute<'q, Self::Database> + 'q, 'c: 'e,

Execute the query and returns at most one row.

fn prepare_with<'e, 'q: 'e>( self, sql: &'q str, _parameters: &'e [OdbcTypeInfo], ) -> BoxFuture<'e, Result<OdbcStatement<'q>, Error>>

where 'c: 'e,

Prepare the SQL query, with parameter type information, to inspect the type information about its parameters and results.

fn execute<'e, 'q: 'e, E>( self, query: E, ) -> BoxFuture<'e, Result<<Self::Database as Database>::QueryResult, Error>>

where E: Execute<'q, Self::Database> + 'q, 'c: 'e,

Execute the query and return the total number of rows affected.

fn execute_many<'e, 'q: 'e, E>( self, query: E, ) -> BoxStream<'e, Result<<Self::Database as Database>::QueryResult, Error>>

where E: Execute<'q, Self::Database> + 'q, 'c: 'e,

Execute multiple queries and return the rows affected from each query, in a stream.

fn fetch<'e, 'q: 'e, E>( self, query: E, ) -> BoxStream<'e, Result<<Self::Database as Database>::Row, Error>>

where E: Execute<'q, Self::Database> + 'q, 'c: 'e,

Execute the query and return the generated results as a stream.

fn fetch_all<'e, 'q: 'e, E>( self, query: E, ) -> BoxFuture<'e, Result<Vec<<Self::Database as Database>::Row>, Error>>

where E: Execute<'q, Self::Database> + 'q, 'c: 'e,

Execute the query and return all the generated results, collected into a Vec.

fn fetch_one<'e, 'q: 'e, E>( self, query: E, ) -> BoxFuture<'e, Result<<Self::Database as Database>::Row, Error>>

where E: Execute<'q, Self::Database> + 'q, 'c: 'e,

Execute the query and returns exactly one row.

fn prepare<'e, 'q: 'e>( self, query: &'q str, ) -> BoxFuture<'e, Result<<Self::Database as HasStatement<'q>>::Statement, Error>>

where 'c: 'e,

Prepare the SQL query to inspect the type information of its parameters and results.

impl From<OdbcConnection> for AnyConnection

Available on (crate features postgres or mysql or mssql or sqlite or odbc) and crate feature any only.

fn from(conn: OdbcConnection) -> Self

Converts to this type from the input type.