Struct PoolConfig 

pub struct PoolConfig {
    pub host: String,
    pub port: u16,
    pub user: String,
    pub database: String,
    pub password: Option<String>,
    pub max_connections: usize,
    pub min_connections: usize,
    pub idle_timeout: Duration,
    pub acquire_timeout: Duration,
    pub connect_timeout: Duration,
    pub max_lifetime: Option<Duration>,
    pub test_on_acquire: bool,
}

Configuration for a PostgreSQL connection pool.

Use the builder pattern to customise settings:

use std::time::Duration;
use qail_pg::driver::pool::PoolConfig;
let config = PoolConfig::new("localhost", 5432, "app", "mydb")
    .password("secret")
    .max_connections(20)
    .acquire_timeout(Duration::from_secs(5));

Fields

host: String

PostgreSQL server hostname or IP address.

port: u16

PostgreSQL server port (default: 5432).

user: String

Database role / user name.

database: String

Target database name.

password: Option<String>

Optional password for authentication.

max_connections: usize

Hard upper limit on simultaneous connections (default: 10).

min_connections: usize

Minimum idle connections kept warm in the pool (default: 1).

idle_timeout: Duration

Close idle connections after this duration (default: 10 min).

acquire_timeout: Duration

Maximum time to wait when acquiring a connection (default: 30s).

connect_timeout: Duration

TCP connect timeout for new connections (default: 10s).

max_lifetime: Option<Duration>

Optional maximum lifetime of any connection in the pool.

test_on_acquire: bool

When true, run a health check (SELECT 1) before handing out a connection.

Implementations

impl PoolConfig

pub fn new(host: &str, port: u16, user: &str, database: &str) -> Self

Create a new pool configuration with sensible defaults.

Arguments

• host — PostgreSQL server hostname or IP.
• port — TCP port (typically 5432).
• user — PostgreSQL role name.
• database — Target database name.

pub fn password(self, password: &str) -> Self

Set password for authentication.

pub fn max_connections(self, max: usize) -> Self

Set maximum simultaneous connections.

pub fn min_connections(self, min: usize) -> Self

Set minimum idle connections.

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

Set idle timeout (connections idle longer than this are closed).

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

Set acquire timeout (max wait time when getting a connection).

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

Set connect timeout (max time to establish new connection).

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

Set maximum lifetime of a connection before recycling.

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

Enable connection validation on acquire.

pub fn from_qail_config(qail: &QailConfig) -> PgResult<Self>

Create a PoolConfig from a centralized QailConfig.

Parses postgres.url for host/port/user/database/password and applies pool tuning from [postgres] section.

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.