agdb

图数据库。

  Agnesoft 图数据库

快速入门 Db | 快速入门客户端 | 查询 | 决策树

为何不是SQL？

Agnesoft 图数据库（又名agdb）是一个持久的、可选的内存映射图数据库，具有本地的'no-text'对象查询。它可以作为主要持久存储、数据分析平台，以及快速的内存缓存。其无类型的无模式数据存储允许灵活且无缝地更新数据，无需停机或昂贵的迁移。所有查询都是通过构建器模式或直接作为对象构建，无需特殊语言或文本解析。

• 主要功能
• 概览
• 容器功能
• 决策树
• 路线图
• 参考

  主要功能

• 图表上绘制的数据
• 附加到图元素（节点和边）上的键值属性（类型）
• 持久平台无关的基于文件的存储（可在平台间转移）
• 符合ACID规范
• 对象查询采用构建器模式（无文本，无查询语言）
• 内存映射以提高查询速度
• 服务器模式
• 支持任何编程语言的OpenAPI客户端
• 云托管SaaS数据库
• Db自身无依赖

  快速了解[Db]

cargo add agdb

基本使用示例，展示创建数据库、插入带数据的图元素以及使用选择和搜索查询它们。使用此代码的功能必须处理 agdb::DbError 和 agdb::QueryError 错误类型，以便操作符 ? 可以正常工作

use agdb::{Db, DbId, QueryBuilder, UserValue, DbUserValue, Comparison::Equal};

let mut db = Db::new("db_file.agdb")?;

db.exec_mut(&QueryBuilder::insert().nodes().aliases("users").query())?;

#[derive(Debug, UserValue)]
struct User { db_id: Option<DbId>, name: String, }
let users = vec![User { db_id: None, name: "Alice".to_string(), },
                 User { db_id: None, name: "Bob".to_string(), },
                 User { db_id: None, name: "John".to_string(), }];

let users_ids = db.exec_mut(&QueryBuilder::insert().nodes().values(&users).query())?;

db.exec_mut(
    &QueryBuilder::insert()
        .edges()
        .from("users")
        .to(&users_ids)
        .query(),
)?;

此代码创建了一个名为 user_db.agdb 的数据库，其中包含一个简单的包含4个节点的图。第一个节点被别名为 users，然后Alice、Bob和John的3个用户节点通过边连接到 users 节点。将任意的 name 属性附加到用户节点上。我们使用自己的类型，并从 agdb::UserValue 继承，而不是直接使用键插入值（这同样可行），以便它可以与数据库一起使用。

您可以通过它们的ID选择图元素（节点和边），并获取与关联数据（键值属性）相关的数据。让我们选择我们的用户并将结果转换为列表（注意我们仅选择与我们的 User 类型相关的值，通过传递 User::db_keys()）

let users: Vec<User> = db
    .exec(
        &QueryBuilder::select()
            .values(User::db_keys())
            .ids(&users_ids)
            .query(),
    )?
    .try_into()?;

println!("{:?}", users);
// [User { db_id: Some(DbId(2)), username: "Alice" },
//  User { db_id: Some(DbId(3)), username: "Bob" },
//  User { db_id: Some(DbId(4)), username: "John" }]

您还可以通过条件搜索图以仅获取某些元素。例如

let user: User = db
    .exec(
        &QueryBuilder::select()
            .values(User::db_keys())
            .ids(
                QueryBuilder::search()
                    .from("users")
                    .where_()
                    .key("name")
                    .value(Equal("Bob".into()))
                    .query(),
            )
            .query(),
    )?
    .try_into()?;

println!("{:?}", user);
// User { db_id: Some(DbId(3)), username: "Bob" }

有关数据库概念和基本数据类型，请参阅 概念。有关所有查询的全面概述，请参阅 查询 参考，或继续深入了解 高效的agdb。

  Crate功能

agdb

agdb_api

  决策树

flowchart TD;
    A[Embedded or server?] --> Embedded
    A --> B[Client or hosting?]
    Embedded --> Studio[<a href='https://github.com/agnesoft/agdb/blob/main/docs/studio.md'>Studio</a>]
    Embedded --> Queries[<a href='https://github.com/agnesoft/agdb/blob/main/docs/queries.md'>Queries</a>]
    B --> Client
    B --> Hosting
    Client --> API[<a href='https://github.com/agnesoft/agdb/blob/main/docs/api.md'>API</a>]
    Client --> Studio
    Client --> Queries
    Hosting --> Server[<a href='https://github.com/agnesoft/agdb/blob/main/docs/server.md'>Server</a>]
    Hosting --> Cloud[<a href='https://github.com/agnesoft/agdb/blob/main/docs/cloud.md'>Cloud</a>]

  路线图

以下为计划中的功能

  参考

• API

• 但是为什么？

• 云

• 概念

• 高效的 agdb

• 指南

• 性能

• 查询

• 服务器

• Studio

• 故障排除