Struct PoolConfig 

pub struct PoolConfig {
    pub connection: ConnectionOptions,
    pub pool: PoolOptions,
    pub retry_attempts: u32,
    pub retry_delay: Duration,
    pub health_check_interval: Option<Duration>,
}

Complete pool configuration combining connection and pool options.

Fields

connection: ConnectionOptions

Connection options.

pool: PoolOptions

Pool options.

retry_attempts: u32

Number of retry attempts for failed connections.

retry_delay: Duration

Delay between retry attempts.

health_check_interval: Option<Duration>

Health check interval.

Implementations

impl PoolConfig

pub fn new() -> Self

Create a new pool configuration.

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

Set connection options.

pub fn pool(self, options: PoolOptions) -> Self

Set pool options.

pub fn max_connections(self, n: u32) -> Self

Set max connections.

pub fn min_connections(self, n: u32) -> Self

Set min connections.

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

Set connection timeout.

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

Set acquire timeout.

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

Set idle timeout.

pub fn max_lifetime(self, lifetime: Duration) -> Self

Set max lifetime.

pub fn retry_attempts(self, attempts: u32) -> Self

Set retry attempts.

pub fn retry_delay(self, delay: Duration) -> Self

Set retry delay.

pub fn health_check_interval(self, interval: Duration) -> Self

Set health check interval.

pub fn no_health_check(self) -> Self

Disable health checks.

pub fn low_latency() -> Self

Create a configuration optimized for low-latency.

pub fn high_throughput() -> Self

Create a configuration optimized for high throughput.

pub fn development() -> Self

Create a configuration for development/testing.

pub fn read_heavy() -> Self

Create a configuration optimized for read-heavy workloads.

Features:

• More connections (reads can parallelize)
• Longer connection lifetime (cached statement benefits)
• Moderate health check interval

pub fn write_heavy() -> Self

Create a configuration optimized for write-heavy workloads.

Features:

• Fewer connections (writes are serialized)
• Shorter lifetime (avoid long-running transactions)
• Frequent health checks

pub fn mixed_workload() -> Self

Create a configuration optimized for mixed workloads.

Balanced settings for applications with both reads and writes.

pub fn batch_processing() -> Self

Create a configuration optimized for batch processing.

Features:

• Longer timeouts for batch operations
• More connections for parallel batch processing
• Infrequent health checks

pub fn serverless() -> Self

Create a configuration for serverless environments.

Features:

• Quick connection acquisition
• Aggressive connection recycling
• No minimum connections (cold start friendly)

pub fn for_workload(qps: u32, avg_query_ms: u32) -> Self

Recommend a configuration based on expected queries per second.

Arguments

• qps - Expected queries per second
• avg_query_ms - Average query duration in milliseconds

Example

use prax_query::connection::PoolConfig;

// 100 queries/sec with 10ms average latency
let config = PoolConfig::for_workload(100, 10);
assert!(config.pool.max_connections >= 5);

Trait Implementations

impl Clone for PoolConfig

fn clone(&self) -> PoolConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PoolConfig

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

Formats the value using the given formatter.

impl Default for PoolConfig

fn default() -> Self

Returns the “default value” for a type.