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::ZkeMode;
pub use config::ZkeEncryptionConfig;
pub use storage::StorageEngine;
pub use crypto::ZkeConfig;
pub use crypto::ZkeDerivedKeys;
pub use crypto::ZkeKeyDerivation;
pub use crypto::ZkeRequestContext;
pub use crypto::ZeroKnowledgeSession;
pub use crypto::NonceTracker;
pub use crypto::TimestampValidator;

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
PostgreSQL wire protocol network server
optimizer
Query optimizer
protocol
Protocol implementations
protocols
Protocol integration layer
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
Embedded database instance
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