Struct VectorQueryBuilder 

pub struct VectorQueryBuilder { /* private fields */ }

Builder for pgvector SQL queries.

This struct generates SQL for vector similarity search and manipulation operations using PostgreSQL’s pgvector extension.

Implementations

impl VectorQueryBuilder

pub fn new() -> Self

Create a new vector query builder.

pub fn with_question_marks() -> Self

Create a builder with question mark placeholders.

pub fn similarity_search( &self, query: &VectorSearchQuery, query_embedding: &[f32], ) -> (String, Vec<VectorParam>)

Build a similarity search query.

Generates SQL like:

SELECT id, content, (embedding <=> $1::vector) AS distance
FROM documents
WHERE metadata->>'type' = 'article'
ORDER BY embedding <=> $1::vector
LIMIT 10

Arguments

• query - The search query configuration
• query_embedding - The embedding vector to search for

Returns

A tuple of (SQL string, parameter values)

pub fn insert_one( &self, query: &VectorInsertQuery, values: &[VectorParam], ) -> (String, Vec<VectorParam>)

Build a single vector insert query.

Generates SQL like:

INSERT INTO documents (id, content, embedding)
VALUES ($1, $2, $3::vector)
RETURNING id

pub fn insert_batch( &self, query: &VectorInsertQuery, rows: &[Vec<VectorParam>], ) -> (String, Vec<VectorParam>)

Build a batch vector insert query.

Generates SQL like:

INSERT INTO documents (id, content, embedding)
VALUES
  ($1, $2, $3::vector),
  ($4, $5, $6::vector),
  ($7, $8, $9::vector)
RETURNING id

pub fn create_index( &self, config: &VectorConfig, table: &str, column: &str, ) -> Option<String>

Build a query to create a vector index.

Generates SQL like:

CREATE INDEX ON documents USING hnsw (embedding vector_cosine_ops)

Trait Implementations

impl Clone for VectorQueryBuilder

fn clone(&self) -> VectorQueryBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VectorQueryBuilder

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

Formats the value using the given formatter.

impl Default for VectorQueryBuilder

fn default() -> VectorQueryBuilder

Returns the “default value” for a type.