Struct DatabaseConfig 

#[non_exhaustive]
pub struct DatabaseConfig {
    pub url: String,
    pub pool_size: u32,
    pub pool_timeout: DurationStr,
    pub statement_timeout: DurationStr,
    pub replica_urls: Vec<String>,
    pub read_from_replica: bool,
    pub replica_pool_size: Option<u32>,
    pub min_pool_size: u32,
    pub test_before_acquire: bool,
}

Database configuration. One pool, no per-workload isolation: workload separation belongs at the worker level, not the connection level. The single-pool contention model and sizing formula are documented at the runtime side in forge_runtime::pg::pool module docs.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

url: String

PostgreSQL connection URL.

pool_size: u32

Connection pool size. Should be sized as `worker.max_concurrent + reactor cap + expected gateway concurrency

• ~6 for persistent listeners, leader holds, and headroom. See forge_runtime::pg::pool` module docs.

pool_timeout: DurationStr

Pool checkout timeout duration (e.g. “30s”, “1m”).

statement_timeout: DurationStr

Statement timeout duration (e.g. “30s”, “5m”).

replica_urls: Vec<String>

Read replica URLs for scaling reads.

read_from_replica: bool

Whether to route read queries to replicas.

replica_pool_size: Option<u32>

Replica pool size. When unset, defaults to pool_size / 2.

min_pool_size: u32

Minimum connections to keep alive in the pool (pre-warming).

test_before_acquire: bool

Run a health check query before handing out connections. Disabling this halves round-trips for read queries.

Implementations

impl DatabaseConfig

pub fn new(url: impl Into<String>) -> Self

Create a config with a database URL.

pub fn url(&self) -> &str

Get the database URL.

pub fn validate(&self) -> Result<()>

Validate the database configuration.

Trait Implementations

impl Clone for DatabaseConfig

fn clone(&self) -> DatabaseConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DatabaseConfig

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

Formats the value using the given formatter.

impl Default for DatabaseConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DatabaseConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DatabaseConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.