Struct Query 

pub struct Query {
    pub root: QueryNode,
}

Search query AST

Fields

root: QueryNode

Root query node

Implementations

impl Query

pub fn new(root: QueryNode) -> Self

Create a new query from a root node

pub fn field_eq(field: impl Into<String>, value: impl Into<String>) -> Self

Create a field equals query: @field:value

pub fn tags(field: impl Into<String>, values: Vec<String>) -> Self

Create a tag query: @tags:{value1|value2}

pub fn numeric_range( field: impl Into<String>, min: Option<f64>, max: Option<f64>, ) -> Self

Create a numeric range query: @age:[min max]

pub fn text_search(field: impl Into<String>, text: impl Into<String>) -> Self

Create a full-text search query (contains)

pub fn prefix(field: impl Into<String>, prefix: impl Into<String>) -> Self

Create a prefix match query: @field:prefix*

pub fn fuzzy(field: impl Into<String>, text: impl Into<String>) -> Self

Create a fuzzy match query: @field:%value%

pub fn vector(field: impl Into<String>, vector: Vec<f32>, k: usize) -> Self

Create a vector similarity (KNN) search query.

Returns the k nearest neighbors by vector similarity.

Arguments

• field - The vector field name (must be indexed with vector_hnsw/vector_flat)
• vector - Query embedding vector (must match field dimensionality)
• k - Number of nearest neighbors to return

Example

let embedding = vec![0.1, 0.2, 0.3, /* ... 1536 dims for OpenAI */];
let query = Query::vector("embedding", embedding, 10);
let results = engine.search("documents", &query).await?;

pub fn vector_filtered( filter: Query, field: impl Into<String>, vector: Vec<f32>, k: usize, ) -> Self

Create a filtered vector search query.

Combines a filter query with vector KNN search. The filter is applied first, then KNN is performed on the filtered results.

Example

let embedding = get_embedding("semantic search query");
let query = Query::vector_filtered(
    Query::tags("category", vec!["tech".into()]),
    "embedding",
    embedding,
    10
);

pub fn and(self, other: Query) -> Self

Combine with AND

pub fn or(self, other: Query) -> Self

Combine with OR

pub fn negate(self) -> Self

Negate query

Trait Implementations

impl Clone for Query

fn clone(&self) -> Query

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Query

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Query

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Query

fn eq(&self, other: &Query) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Query

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Query