Struct Vector 

pub struct Vector {
    pub id: String,
    pub attributes: Vec<Attribute>,
}

A vector with its identifying ID, embedding values, and metadata.

Identity

A vector is uniquely identified by its id within a namespace. The ID is a user-provided string (max 64 bytes UTF-8) that serves as an external identifier. The system internally maps external IDs to compact u64 internal IDs for efficient storage and indexing.

Upsert Semantics

Writing a vector with an existing ID replaces the previous vector. The old vector is marked as deleted and a new internal ID is allocated. This ensures posting lists and metadata indexes are updated correctly without expensive read-modify-write cycles.

Embedding Values

The embedding vector must be provided as an attribute with name “vector” and type AttributeValue::Vector. The length must match the dimensions specified in the Config when the database was created.

Fields

id: String

User-provided unique identifier (max 64 bytes UTF-8).

attributes: Vec<Attribute>

Attributes including the embedding vector (under “vector” field) and metadata.

Implementations

impl Vector

pub fn new(id: impl Into<String>, values: Vec<f32>) -> Self

Creates a new vector with just the embedding values (no other attributes).

The vector values are stored as an attribute with name VECTOR_FIELD_NAME.

pub fn builder(id: impl Into<String>, values: Vec<f32>) -> VectorBuilder

Builder-style construction for vectors with attributes.

The vector values are stored as an attribute with name VECTOR_FIELD_NAME.

pub fn attribute(&self, name: &str) -> Option<&AttributeValue>

Trait Implementations

impl Clone for Vector

fn clone(&self) -> Vector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vector

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

Formats the value using the given formatter.