Struct ExaConnection 

pub struct ExaConnection { /* private fields */ }

A connection to the Exasol database. Implementor of Connection.

Implementations

impl ExaConnection

pub fn server(&self) -> SocketAddr

Returns the Exasol server socket address that we’re connected to.

pub fn attributes(&self) -> &ExaAttributes

Returns a reference of the ExaAttributes used in this connection.

pub fn attributes_mut(&mut self) -> &mut ExaAttributes

Allows setting connection attributes through the driver.

Note that attributes will only reach Exasol after a statement is executed or after explicitly calling the flush_attributes() method.

pub async fn flush_attributes(&mut self) -> Result<()>

Flushes the current ExaAttributes to Exasol.

Errors

Will return an error if sending the attributes fails.

pub fn session_info(&self) -> &SessionInfo

Returns a reference to the SessionInfo related to this connection.

Trait Implementations

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

type Database = Exasol

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

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

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

impl Connection for ExaConnection

type Database = Exasol

type Options = ExaConnectOptions

async fn close(self) -> Result<()>

Explicitly close this database connection.

async fn ping(&mut self) -> Result<()>

Checks if a connection to the database is still valid.

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

where Self: Sized,

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

fn shrink_buffers(&mut self)

Restore any buffers in the connection to their default capacity, if possible.

fn cached_statements_size(&self) -> usize

where Self::Database: HasStatementCache,

The number of statements currently cached in the connection.

async fn clear_cached_statements(&mut self) -> Result<()>

where Self::Database: HasStatementCache,

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

fn begin_with( &mut self, statement: impl SqlSafeStr, ) -> impl Future<Output = Result<Transaction<'_, Self::Database>, Error>> + Send

where Self: Sized,

Begin a new transaction with a custom statement.

fn is_in_transaction(&self) -> bool

Returns true if the connection is currently in a transaction.

fn transaction<'a, F, R, E>( &'a mut self, callback: F, ) -> impl Future<Output = Result<R, E>> + Send + 'a

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

Execute the function inside a transaction.

fn connect( url: &str, ) -> impl Future<Output = Result<Self, Error>> + Send + 'static

where Self: Sized,

Establish a new database connection.

fn connect_with( options: &Self::Options, ) -> impl Future<Output = Result<Self, Error>> + Send

where Self: Sized,

Establish a new database connection with the provided options.

impl Debug for ExaConnection

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

Formats the value using the given formatter.

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

type Database = Exasol

fn execute<'e, 'q, E>(self, query: E) -> BoxFuture<'e, Result<ExaQueryResult>>

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

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

fn execute_many<'e, 'q, E>( self, query: E, ) -> BoxStream<'e, Result<ExaQueryResult>>

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

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

fn fetch<'e, 'q, E>(self, query: E) -> BoxStream<'e, Result<ExaRow>>

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

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

fn fetch_many<'e, 'q, E>( self, query: E, ) -> BoxStream<'e, Result<Either<ExaQueryResult, ExaRow>>>

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

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

fn fetch_all<'e, 'q: 'e, E>( self, query: E, ) -> BoxFuture<'e, Result<Vec<ExaRow>>>

where E: 'q + Execute<'q, Self::Database>, '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<ExaRow>>

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

Execute the query and returns exactly one row.

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

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

Execute the query and returns at most one row.

fn prepare_with<'e>( self, sql: SqlStr, _parameters: &'e [ExaTypeInfo], ) -> BoxFuture<'e, Result<ExaStatement>>

where 'c: 'e,

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

fn prepare<'e>( self, query: SqlStr, ) -> Pin<Box<dyn Future<Output = Result<<Self::Database as Database>::Statement, Error>> + Send + 'e>>

where 'c: 'e,

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