Struct Limits 

pub struct Limits {
    pub max_k: usize,
    pub max_ef_search: usize,
    pub max_fetch_limit: usize,
    pub max_vector_dim: usize,
    pub max_payload_bytes: usize,
    pub max_batch_size: usize,
    pub max_request_body_bytes: usize,
    pub max_sparse_terms: usize,
    pub max_bulk_batch_size: usize,
}

Per-request cost limits (ADR-0040). Each cap bounds the work a single authenticated request can demand, so one oversized request cannot exhaust the node under the single-writer model (ADR-0006). Over-limit requests are rejected with HTTP 400 / gRPC InvalidArgument rather than silently clamped — a truncated k or ef_search would return surprising, lower-quality results with no signal. Defaults are generous; raise a cap with a [limits] table in quiver.toml or the matching QUIVER_MAX_* environment variable.

Fields

max_k: usize

Maximum k (top-k) for search / search_multi_vector.

max_ef_search: usize

Maximum search beam width (ef_search).

max_fetch_limit: usize

Maximum fetch page size.

max_vector_dim: usize

Maximum vector dimension: the declared collection dimension at creation and the length of any query vector (per token, for multi-vector).

max_payload_bytes: usize

Maximum serialized-JSON payload size per point, in bytes.

max_batch_size: usize

Maximum number of points / documents in a single upsert request.

max_request_body_bytes: usize

Maximum HTTP request body size, in bytes (enforced by the REST layer via axum’s DefaultBodyLimit; gRPC is bounded by tonic’s decode limit).

max_sparse_terms: usize

Maximum number of non-zero terms in a hybrid-search sparse query (ADR-0043), bounding the posting-list scan.

max_bulk_batch_size: usize

Maximum number of points in a single bulk upsert (POST …/points:bulk, ADR-0045). Larger than max_batch_size because the bulk path defers index maintenance to one rebuild; the request is still bounded by max_request_body_bytes, so raise that too for very large bulk loads.

Trait Implementations

impl Clone for Limits

fn clone(&self) -> Limits

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Limits

impl Debug for Limits

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

Formats the value using the given formatter.

impl Default for Limits

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Limits

where Limits: 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 Limits

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

where __S: Serializer,

Serialize this value into the given Serde serializer.