agdb

图数据库。

  Agnesoft 图数据库

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

为何不是SQL？

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

• 主要特性
• 一览
• 箱子功能
• 决策树
• 路线图
• 参考

  关键特性

• 图表上的数据
• 附加到图表元素（节点和边）上的键值属性（类型化）
• 持久的平台无关的基于文件的存储（可在不同平台之间传输）
• 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

• 故障排除