Struct ConnectOptions

pub struct ConnectOptions { /* private fields */ }

Defines the configuration options of a database

Implementations

impl ConnectOptions

pub fn new<T>(url: T) -> ConnectOptions

where T: Into<String>,

Create new ConnectOptions for a Database by passing in a URI string

pub fn get_url(&self) -> &str

Get the database URL of the pool

pub fn max_connections(&mut self, value: u32) -> &mut ConnectOptions

Set the maximum number of connections of the pool

pub fn get_max_connections(&self) -> Option<u32>

Get the maximum number of connections of the pool, if set

pub fn min_connections(&mut self, value: u32) -> &mut ConnectOptions

Set the minimum number of connections of the pool

pub fn get_min_connections(&self) -> Option<u32>

Get the minimum number of connections of the pool, if set

pub fn connect_timeout(&mut self, value: Duration) -> &mut ConnectOptions

Set the timeout duration when acquiring a connection

pub fn get_connect_timeout(&self) -> Option<Duration>

Get the timeout duration when acquiring a connection, if set

pub fn idle_timeout(&mut self, value: Duration) -> &mut ConnectOptions

Set the idle duration before closing a connection

pub fn get_idle_timeout(&self) -> Option<Duration>

Get the idle duration before closing a connection, if set

pub fn acquire_timeout(&mut self, value: Duration) -> &mut ConnectOptions

Set the maximum amount of time to spend waiting for acquiring a connection

pub fn get_acquire_timeout(&self) -> Option<Duration>

Get the maximum amount of time to spend waiting for acquiring a connection

pub fn max_lifetime(&mut self, lifetime: Duration) -> &mut ConnectOptions

Set the maximum lifetime of individual connections

pub fn get_max_lifetime(&self) -> Option<Duration>

Get the maximum lifetime of individual connections, if set

pub fn sqlx_logging(&mut self, value: bool) -> &mut ConnectOptions

Enable SQLx statement logging (default true)

pub fn get_sqlx_logging(&self) -> bool

Get whether SQLx statement logging is enabled

pub fn sqlx_logging_level(&mut self, level: LevelFilter) -> &mut ConnectOptions

Set SQLx statement logging level (default INFO). (ignored if sqlx_logging is false)

pub fn sqlx_slow_statements_logging_settings( &mut self, level: LevelFilter, duration: Duration, ) -> &mut ConnectOptions

Set SQLx slow statements logging level and duration threshold (default LevelFilter::Off). (ignored if sqlx_logging is false)

pub fn get_sqlx_logging_level(&self) -> LevelFilter

Get the level of SQLx statement logging

pub fn get_sqlx_slow_statements_logging_settings( &self, ) -> (LevelFilter, Duration)

Get the SQLx slow statements logging settings

pub fn sqlcipher_key<T>(&mut self, value: T) -> &mut ConnectOptions

where T: Into<Cow<'static, str>>,

set key for sqlcipher

pub fn set_schema_search_path<T>( &mut self, schema_search_path: T, ) -> &mut ConnectOptions

where T: Into<String>,

Set schema search path (PostgreSQL only)

pub fn test_before_acquire(&mut self, value: bool) -> &mut ConnectOptions

If true, the connection will be pinged upon acquiring from the pool (default true).

pub fn connect_lazy(&mut self, value: bool) -> &mut ConnectOptions

If set to true, the db connection pool will be created using SQLx’s connect_lazy method.

pub fn get_connect_lazy(&self) -> bool

Get whether DB connections will be established when the pool is created or only as needed.

impl ConnectOptions

pub fn sqlx_pool_options<DB>(self) -> PoolOptions<DB>

where DB: Database,

Convert ConnectOptions into sqlx::pool::PoolOptions

Trait Implementations

impl Clone for ConnectOptions

fn clone(&self) -> ConnectOptions

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectOptions

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

Formats the value using the given formatter.

impl<T> From<T> for ConnectOptions

where T: Into<String>,

fn from(s: T) -> ConnectOptions

Converts to this type from the input type.