Struct Database 

pub struct Database { /* private fields */ }

ADBC Database connection factory.

The Database type represents a database connection configuration and serves as a factory for creating Connection instances. It encapsulates the connection parameters and provides methods to establish connections.

Example

Implementations

impl Database

pub fn new(params: ConnectionParams) -> Self

Create a new Database instance from connection parameters.

Arguments

• params - The connection parameters

Example

pub fn params(&self) -> &ConnectionParams

Get the connection parameters.

Returns

A reference to the connection parameters.

pub fn connection_string(&self) -> &str

Get the connection string (without password).

Returns

A safe display version of the connection string.

pub async fn connect(&self) -> Result<Connection, ConnectionError>

Establish a connection to the database.

This creates a new Connection instance and establishes a connection to the Exasol database using the configured parameters.

Returns

A connected Connection instance.

Errors

Returns ConnectionError if the connection fails.

Example

pub async fn test_connection(&self) -> Result<(), ConnectionError>

Test the connection without establishing a persistent connection.

This attempts to connect to the database and immediately closes the connection, verifying that the connection parameters are valid.

Returns

Ok(()) if the connection test succeeds.

Errors

Returns ConnectionError if the connection test fails.

Example

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 Debug for Database

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

Formats the value using the given formatter.

impl Display for Database

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

Formats the value using the given formatter.

impl FromStr for Database

fn from_str(s: &str) -> Result<Self, Self::Err>

Parse a connection string to create a Database instance.

Arguments

• s - Connection string in the format: exasol://[username[:password]@]host[:port][/schema][?param=value&...]

Returns

A Database instance configured with the parsed parameters.

Errors

Returns ConnectionError if the connection string is invalid.

Example

type Err = ConnectionError

The associated error which can be returned from parsing.