HelixDB Docs

Guide

The published helix-db 3.0.0 crate provides the query DSL, request types, async HTTP client, native graph helpers, and a feature-gated embedded client.

The package is published as helix-db and imported as helix_db.

Install

cargo add helix-db@3.0.0

Or add the dependency directly:

Cargo.toml

[dependencies]
helix-db = "3.0.0"
serde = { version = "1", features = ["derive"] }
serde_json = "1"
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Define a query

use helix_db::dsl::prelude::*;

#[query]
fn find_users(tenant_id: String, limit: i64) -> ReadBatch {
    read_batch()
        .var_as(
            "users",
            g()
                .n_with_label("User")
                .where_(Predicate::eq("tenantId", tenant_id))
                .limit(limit)
                .value_map(Some(vec!["$id", "name", "tenantId"])),
        )
        .returning(["users"])
}

#[query] converts typed arguments into request parameters, sets query_name to the function name, and returns Result<QueryRequest, QueryError>.

Execute

use helix_db::Client;

let client = Client::new(Some("http://localhost:6969"))?;
let request = find_users("acme".to_string(), 25)?;
let response: serde_json::Value = client.query(request).send().await?;

Use .with_api_key(Some("hx_...")) for Helix Cloud. Request-builder options can require the writer, require a warm read, or control durability waiting.

Build without the macro

let request = QueryRequest::read(
    read_batch()
        .var_as("count", g().n_with_label("User").count())
        .returning(["count"]),
)
.with_query_name("count_users");

Embedded runtime

Enable the embedded feature:

cargo add helix-db --features embedded

See Embedded database for storage, cache, and handle configuration.

Verify

Rust SDK crate docs are doctests, and the public #[query] README journeys are compile-tested as examples:

cargo test --manifest-path sdks/rust/Cargo.toml --lib
cargo test --manifest-path sdks/rust/Cargo.toml --doc
cargo check --manifest-path sdks/rust/Cargo.toml --example basic_query
cargo check --manifest-path sdks/rust/Cargo.toml --example readme_sdk_query
cargo check --manifest-path sdks/rust/Cargo.toml --example readme_macros_query

Start Here

Core Concepts

Query Guides

Rust SDK

Install

Define a query

Execute

Build without the macro

Embedded runtime

Verify

Next steps

Query tutorial

Reading data

​Install

​Define a query

​Execute

​Build without the macro

​Embedded runtime

​Verify

​Next steps

Query tutorial

Reading data

Install

Define a query

Execute

Build without the macro

Embedded runtime

Verify

Next steps