Skip to main content

ClientOptions

Struct ClientOptions 

Source
pub struct ClientOptions {
Show 14 fields pub host: String, pub port: u16, pub endpoints: Vec<Endpoint>, pub database: String, pub user: String, pub password: String, pub compression: Option<CompressionMethod>, pub max_compression_chunk_size: usize, pub client_info: ClientInfo, pub connection_options: ConnectionOptions, pub send_retries: u32, pub retry_timeout: Duration, pub ping_before_query: bool, pub rethrow_exceptions: bool,
}
Expand description

Client options

Fields§

§host: String

Server host (used if endpoints is empty)

§port: u16

Server port (used if endpoints is empty)

§endpoints: Vec<Endpoint>

Multiple endpoints for failover (if empty, uses host+port)

§database: String

Database name

§user: String

Username

§password: String

Password

§compression: Option<CompressionMethod>

Compression method

§max_compression_chunk_size: usize

Maximum compression chunk size (default: 65535)

§client_info: ClientInfo

Client information

§connection_options: ConnectionOptions

Connection timeout and TCP options

§send_retries: u32

Number of send retries (default: 1, no retry)

§retry_timeout: Duration

Timeout between retry attempts (default: 5 seconds)

§ping_before_query: bool

Send ping before each query (default: false)

§rethrow_exceptions: bool

Rethrow server exceptions (default: true)

Implementations§

Source§

impl ClientOptions

Source

pub fn new(host: impl Into<String>, port: u16) -> Self

Create new client options with host and port

Source

pub fn endpoints(self, endpoints: Vec<Endpoint>) -> Self

Set multiple endpoints for failover

Source

pub fn add_endpoint(self, host: impl Into<String>, port: u16) -> Self

Add an endpoint for failover

Source

pub fn database(self, database: impl Into<String>) -> Self

Set the database

Source

pub fn user(self, user: impl Into<String>) -> Self

Set the username

Source

pub fn password(self, password: impl Into<String>) -> Self

Set the password

Source

pub fn compression(self, method: Option<CompressionMethod>) -> Self

Set compression method

Source

pub fn max_compression_chunk_size(self, size: usize) -> Self

Set maximum compression chunk size

Source

pub fn connection_options(self, options: ConnectionOptions) -> Self

Set connection options (timeouts, TCP settings)

Source

pub fn send_retries(self, retries: u32) -> Self

Set number of send retries

Source

pub fn retry_timeout(self, timeout: Duration) -> Self

Set retry timeout

Source

pub fn ping_before_query(self, enabled: bool) -> Self

Enable/disable ping before query

Source

pub fn rethrow_exceptions(self, enabled: bool) -> Self

Enable/disable exception rethrowing

Trait Implementations§

Source§

impl Clone for ClientOptions

Source§

fn clone(&self) -> ClientOptions

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for ClientOptions

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for ClientOptions

Source§

fn default() -> Self

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more