Skip to main content

Crate heliosdb_nano

Crate heliosdb_nano 

Source
Expand description

§HeliosDB Nano

A PostgreSQL-compatible embedded database with vector search, encryption, and multi-tenancy.

§Features

  • SQL Database: PostgreSQL 17 compatible (95%+)
  • Vector Search: Built-in HNSW index for embeddings
  • Encryption: Transparent Data Encryption (TDE) with AES-256-GCM
  • Multi-Tenancy: Native tenant isolation with RLS
  • Embedded Mode: SQLite-style in-process usage
  • Server Mode: PostgreSQL-style network server
  • In-Memory Mode: ACID-compliant RAM-only storage

§Quick Start

use heliosdb_nano::EmbeddedDatabase;

// Create in-memory database
let db = EmbeddedDatabase::new_in_memory()?;

// Execute SQL - CREATE TABLE
db.execute("CREATE TABLE users (id INT, name TEXT)")?;

// INSERT data
db.execute("INSERT INTO users (id, name) VALUES (1, 'Alice')")?;

// Query data
let results = db.query("SELECT * FROM users", &[])?;
println!("Found {} users", results.len());

§Architecture

HeliosDB Nano uses only open-source components:

  • Storage: RocksDB (LSM-tree)
  • Columnar: Apache Arrow
  • SQL Parser: sqlparser-rs
  • Vector Index: HNSW (published research)
  • Encryption: AES-256-GCM (NIST standard)
  • Protocol: PostgreSQL wire protocol

Re-exports§

pub use config::Config;
pub use config::KeySource;
pub use config::ProfileConfig;
pub use config::ZkeEncryptionConfig;
pub use config::ZkeMode;
pub use crypto::NonceTracker;
pub use crypto::TimestampValidator;
pub use crypto::ZeroKnowledgeSession;
pub use crypto::ZkeConfig;
pub use crypto::ZkeDerivedKeys;
pub use crypto::ZkeKeyDerivation;
pub use crypto::ZkeRequestContext;
pub use storage::StorageEngine;

Modules§

ai
AI module for HeliosDB-Lite
api
REST API module for HeliosDB-Lite
audit
Audit logging system for HeliosDB Lite
cli
CLI module for HeliosDB-Lite commands
compute
Query execution (Volcano model)
config
Configuration for HeliosDB Lite
crypto
Encryption implementation
git_integration
Git Integration Module
graph
Native graph adjacency-list storage and traversal.
multi_tenant
Multi-Tenant Schema Isolation
network
Legacy PostgreSQL wire protocol network server — deprecated.
optimizer
Query optimizer
protocol
Protocol implementations
protocols
Protocol integration layer
query_trace
Lightweight query tracing for embedded benchmarking.
repl
Interactive REPL for HeliosDB Lite
replication
High Availability Replication Module
runtime
Per-request runtime utilities.
search
Full-text + hybrid search.
session
Session Management Module
sql
SQL parsing and planning
storage
Storage layer for HeliosDB Lite
tenant
Multi-tenancy support
vector
Vector search implementation

Structs§

AgentMessage
Agent message
AgentSession
Agent session
Column
Column definition in a table schema
DocumentData
Document data
DocumentMetadata
Document metadata
EmbeddedDatabase
Schema
Table schema definition
Transaction
Transaction handle
Tuple
A tuple (row) of values
VectorStoreInfo
Vector store information

Enums§

ColumnStorageMode
Column storage mode for per-column storage optimization
DataType
SQL data types (PostgreSQL compatible)
Error
Database error type
Value
Runtime value representation

Type Aliases§

Result
Result type for HeliosDB operations