Struct UnifiedQueryRequest 

pub struct UnifiedQueryRequest {
    pub rank_by: Value,
    pub top_k: usize,
    pub filter: Option<Value>,
    pub include_metadata: bool,
    pub include_vectors: bool,
    pub distance_metric: DistanceMetric,
}

Unified query request with flexible ranking options (Turbopuffer-inspired)

Example

use dakera_client::UnifiedQueryRequest;

// Vector ANN search
let request = UnifiedQueryRequest::vector_search(vec![0.1, 0.2, 0.3], 10);

// Full-text BM25 search
let request = UnifiedQueryRequest::fulltext_search("content", "hello world", 10);

// Custom rank_by with filters
let request = UnifiedQueryRequest::vector_search(vec![0.1, 0.2, 0.3], 10)
    .with_filter(serde_json::json!({"category": {"$eq": "science"}}));

Fields

rank_by: Value

How to rank documents (required)

top_k: usize

Number of results to return

filter: Option<Value>

Optional metadata filter

include_metadata: bool

Include metadata in results

include_vectors: bool

Include vectors in results

distance_metric: DistanceMetric

Distance metric for vector search (default: cosine)

Implementations

impl UnifiedQueryRequest

pub fn vector_search(query_vector: Vec<f32>, top_k: usize) -> Self

Create a new unified query request with vector ANN search

pub fn vector_knn_search(query_vector: Vec<f32>, top_k: usize) -> Self

Create a new unified query request with vector kNN search

pub fn fulltext_search( field: impl Into<String>, query: impl Into<String>, top_k: usize, ) -> Self

Create a new unified query request with full-text BM25 search

pub fn attribute_order( field: impl Into<String>, direction: SortDirection, top_k: usize, ) -> Self

Create a new unified query request with attribute ordering

pub fn with_rank_by(rank_by: Value, top_k: usize) -> Self

Create a unified query with a raw rank_by JSON value

pub fn with_filter(self, filter: Value) -> Self

Add a filter to the query

pub fn include_metadata(self, include: bool) -> Self

Set whether to include metadata

pub fn include_vectors(self, include: bool) -> Self

Set whether to include vector values

pub fn with_distance_metric(self, metric: DistanceMetric) -> Self

Set the distance metric

pub fn with_top_k(self, top_k: usize) -> Self

Set the number of results to return

Trait Implementations

impl Clone for UnifiedQueryRequest

fn clone(&self) -> UnifiedQueryRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UnifiedQueryRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for UnifiedQueryRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for UnifiedQueryRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.