Struct DatabaseRuntimeConfig 

pub struct DatabaseRuntimeConfig {
    pub url: Option<String>,
    pub pool_min: usize,
    pub pool_max: usize,
    pub connect_timeout_ms: u64,
    pub ssl_mode: Option<String>,
    pub transaction_retry: Option<TransactionRetryConfig>,
}

Database connection pool runtime configuration.

The [database] section in fraiseql.toml is optional. When absent, connection parameters fall back to the DATABASE_URL environment variable or the --database CLI flag.

Supports ${VAR} environment variable interpolation in the url field:

[database]
url      = "${DATABASE_URL}"
pool_min = 2
pool_max = 20
ssl_mode = "prefer"

Fields

url: Option<String>

Database connection URL. Supports ${VAR} interpolation.

If not set here, the runtime falls back to the DATABASE_URL environment variable or the --database CLI flag.

pool_min: usize

Minimum connection pool size. Default: 2.

pool_max: usize

Maximum connection pool size. Default: 20.

connect_timeout_ms: u64

Connection acquisition timeout in milliseconds. Default: 5 000 (5 s).

ssl_mode: Option<String>

PostgreSQL SSL mode: "disable", "prefer", "require", or "verify-full". Default: "prefer".

Reaches the connection pool through postgres_tls. It was previously validated here and then dropped by build_config_from, so fraiseql run connected in cleartext under ssl_mode = "require" while a typo in the same field failed loudly — the rejected typo being the reason an operator believed the setting was live (#824).

Unset means “whatever the connection URL says”, not “prefer”: a concrete default here would override an explicit ?sslmode=require in url with a value the operator never wrote.

transaction_retry: Option<TransactionRetryConfig>

[database.transaction_retry]: how often a mutation’s transaction runs when PostgreSQL aborts it with 40P01 or 40001 (#1879). Absent, once. An empty table opts in at its defaults. The server file’s [transaction_retry], in the same shape.

Implementations

impl DatabaseRuntimeConfig

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

Validate the database runtime configuration.

Errors

Returns an error if:

• pool_min > pool_max
• ssl_mode is not one of the recognised values

pub fn from_document(document: &Value) -> Result<Self>

The [database] section of a parsed fraiseql.toml, or the default when the file has none.

Reads that one section rather than the whole document, so it serves any fraiseql.toml a command was given, whichever other sections it carries.

Errors

Returns an error if [database] holds a key this struct does not know or a value of the wrong type.

pub fn postgres_tls(&self) -> Result<PostgresTlsConfig>

Transport security for the pool fraiseql run builds.

Errors

Returns an error if ssl_mode names a mode the connector cannot honour.

pub const fn pool_timeout_secs(&self) -> u64

Pool acquisition timeout in whole seconds, rounded up and floored at one.

connect_timeout_ms / 1000 truncated any sub-second value to 0, which deadpool applies to its create slot as Duration::ZERO; a TCP connect plus the PostgreSQL startup handshake cannot finish on the first poll, so every connection attempt failed with a pool timeout against a perfectly healthy server, naming a timeout the operator never configured (#824).

Trait Implementations

impl Clone for DatabaseRuntimeConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DatabaseRuntimeConfig

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

Formats the value using the given formatter.

impl Default for DatabaseRuntimeConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DatabaseRuntimeConfig

where DatabaseRuntimeConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DatabaseRuntimeConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.