Struct ServerConfig 

pub struct ServerConfig {
    pub backend: Backend,
    pub listen: IpAddr,
    pub port: u16,
    pub workers: Option<usize>,
    pub prefix: String,
    pub compress: bool,
    pub max_body_bytes: usize,
    pub max_page_size: u64,
    pub request_timeout_ms: u64,
    pub shutdown_timeout_secs: u64,
    pub quack: QuackConfig,
}

Fields

backend: Backend

Which engine to run. Must match the binary’s compile-time feature.

listen: IpAddr

Listen address. Defaults to loopback (127.0.0.1) — explicitly opt in to 0.0.0.0 if you want to expose the port.

port: u16

TCP port.

workers: Option<usize>

Number of actix worker threads. None (= unset) → one per CPU.

prefix: String

Optional URL path prefix — useful when sitting behind a reverse proxy that rewrites e.g. /datapress/... → /.... When set, every route is mounted under this prefix (so the proxy can pass the URL through unchanged). Must start with / and not end with /; the empty string (default) means no prefix.

compress: bool

Negotiate response compression (gzip / brotli / zstd) via the Accept-Encoding request header. Enabled by default. Disable when running behind a proxy that already compresses, or when the extra CPU is not worth the bandwidth saving.

max_body_bytes: usize

Maximum accepted JSON request body size, in bytes. Larger bodies are rejected with 413 Payload Too Large before any handler runs. Default 1 MiB. Most query bodies are well under 10 KiB; this is a DoS guard, not a tuning knob.

max_page_size: u64

Maximum rows returned by a single /query page. Larger page_size values are clamped before the backend runs. Default 100_000.

request_timeout_ms: u64

Per-request handler timeout, in milliseconds. If a handler hasn’t produced a response within this budget the request is aborted with 504 Gateway Timeout. Default 30_000 (30 s). Set 0 to disable.

shutdown_timeout_secs: u64

Grace period for in-flight requests after the server has received SIGTERM / SIGINT, in seconds. The listening socket is closed immediately; existing connections then have up to this many seconds to finish before workers are force-stopped. Default 30.

quack: QuackConfig

Optional DuckDB Quack remote SQL server. Only used by the DuckDB backend; ignored by DataFusion.

Trait Implementations

impl Debug for ServerConfig

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

Formats the value using the given formatter.

impl Default for ServerConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ServerConfig

where ServerConfig: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.