HelixDB Docs

Guide

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

The v3 SDK packages have not been published yet. The package names and installation commands on this page describe the upcoming v3 release.

Install

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 and sets query_name to the function name.

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@3.0.0 --features embedded

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

Verify

Rust SDK documentation examples are doctests:

cargo test --manifest-path sdks/rust/Cargo.toml --doc

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