Struct MetadataCollection 

pub struct MetadataCollection { /* private fields */ }

A metadata-only collection storing structured payloads without vector indexes.

Examples

use velesdb_core::{MetadataCollection, Point};
use serde_json::json;

let coll = MetadataCollection::create("./data/products".into(), "products")?;

coll.upsert(vec![
    Point::metadata_only(1, json!({"name": "Widget", "price": 9.99})),
])?;

Implementations

impl MetadataCollection

pub fn create(path: PathBuf, name: &str) -> Result<Self>

Creates a new MetadataCollection.

Errors

Returns an error if the directory cannot be created or storage fails.

pub fn open(path: PathBuf) -> Result<Self>

Opens an existing MetadataCollection from disk.

Errors

Returns an error if config or storage cannot be opened.

pub fn flush(&self) -> Result<()>

Flushes to disk.

Errors

Returns an error if the flush fails.

pub fn name(&self) -> String

Returns the collection name.

pub fn len(&self) -> usize

Returns the number of items in the collection.

pub fn is_empty(&self) -> bool

Returns true if the collection is empty.

pub fn all_ids(&self) -> Vec<u64>

Returns all stored IDs.

pub fn upsert(&self, points: impl IntoIterator<Item = Point>) -> Result<()>

Inserts or updates metadata points (must have no vector).

Errors

Returns an error if a point carries a non-empty vector, or if storage operations fail.

pub fn get(&self, ids: &[u64]) -> Vec<Option<Point>>

Retrieves items by IDs.

pub fn delete(&self, ids: &[u64]) -> Result<()>

Deletes items by IDs.

Errors

Returns an error if storage operations fail.

pub fn text_search(&self, query: &str, k: usize) -> Vec<SearchResult>

Performs BM25 full-text search over payloads.

pub fn execute_query( &self, query: &Query, params: &HashMap<String, Value>, ) -> Result<Vec<SearchResult>>

Executes a VelesQL query.

Errors

Returns an error if the query is invalid or execution fails.

pub fn execute_query_str( &self, sql: &str, params: &HashMap<String, Value>, ) -> Result<Vec<SearchResult>>

Executes a raw VelesQL string.

Errors

Returns an error if parsing or execution fails.

Trait Implementations

impl Clone for MetadataCollection

fn clone(&self) -> MetadataCollection

Returns a duplicate of the value.

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

Performs copy-assignment from source.