当前版本:v0.25.4 — 所有发布版本。
一句话概括: Slater 通过标准 Bolt 协议提供无法装入内存的图——数亿个节点和数十亿条边,仅占用低至数百 MB 的 RAM——因此任何 neo4j 驱动都能直接使用,磁盘原生的向量搜索与图并存,并且支持实时、持久化写入而无需放弃上述优势。常驻内存由你选择的缓存预算决定,而非图的规模。
快捷导航
| 为什么需要 Slater | 读取与写入 | 你能获得什么 | 功能特性 |
| 使用 Docker 运行 | 工作原理 | 可写层 | 存储后端 |
| 挂载 | 配置 | ACL | 健康检查 |
| 完整示例 | 开发 | 性能 | 许可证 |
| Graphiti 记忆存储 | 📖 完整手册 |
图数据库将数据存储为事物(节点)以及它们之间的关系(边),关系是一等公民。当你的问题涉及连接而非行时,这正是你想要的——"谁在这个账户的三跳范围内?"、"这个构建背后的完整依赖链是什么?"、"哪些账户共享同一设备、地址和银行卡?"——这些查询在 SQL 中会变成递归连接的泥潭,但在图中却能自然得出。
关于图数据库最常见的抱怨是它们无法扩展到超出内存容量的规模。 许多图数据库(如 neo4j、Memgraph、FalkorDB 等)将整个图常驻内存:一个 40 GB 的图需要 40 GB 内存——每个实例。想要每个区域、每个租户或每个 Pod 一个副本?账单成倍增长。而且超过一定规模它们根本无法加载:例如 9000 万节点 / 15 亿条边的 Wikidata 图需要约 64–128 GiB 常驻内存,因此内存引擎完全无法打开它。
Slater 正是对此的反驳。它不将图加载到内存,而是离线编译一次:slater-build 将你的数据转换为内容寻址的、不可变的磁盘镜像,然后任意数量的 Slater 服务器通过 Bolt 提供该镜像(因此你现有的 neo4j 驱动可直接使用),按需分页加载块,仅保持固定的缓存预算常驻。这就是同一个 9000 万节点的图如何从几百 MB 的 RAM 中提供服务——图规模与内存开销解耦。一个 4 GB 的图和一个 400 GB 的图服务时消耗相同的 RAM,因此你可以廉价地横向扩展无状态只读副本,让存储而非堆内存来持有图。
这使它天然适合 RAG 背后的知识图谱、推荐图和身份图、依赖图——任何大型且互联、你希望廉价且频繁查询的场景。磁盘原生的向量搜索与图并存,因此同一引擎也是嵌入的检索层。
编译一次并不意味着冻结。该镜像是一个基础,而非最终状态:一个可选的写入层位于其上,因此实时图可以被修正和扩展,而无需重建任何东西。
核心不可变,图则不然。开启可写层(delta.enabled)后,你便可在 Bolt 之上进行写入——修正一个属性、添加一个节点、撤回一条边——变更会持久落地,无需重建镜像。让读取侧保持低开销的关键在于写入存放的位置。
写入累积在不可变核心之上的日志结构合并(LSM)层中:一个预写日志和一张内存表,溢出到不可变的增量段,再通过周期性合并折回一个全新的核心。这带来了什么:
count(*)、标签和关系类型的边际统计——即使有未完成的写入也仍是元数据读取:增量维护自己的计数器,因此对一个拥有 9160 万节点、且有 50 万条待处理写入的核心执行 count(*),仍能在几十毫秒内返回,且不触碰任何一个数据块。fsync 完成后才返回 SUCCESS。将写入分组,它们就很廉价——一次写入 UNWIND 每批提交一次 fsync,而非每行一次。MERGE / MATCH … SET / DELETE(以及 CREATE / REMOVE、分离删除、关系写入)——或等效的 ISO GQL 数据修改语句(INSERT / SET / REMOVE / DELETE),它们会下沉到同一条路径。对节点和边进行修正、插入、upsert 和撤回,以你数据本就采用的方式寻址。关闭该层——即默认状态——Slater 提供纯粹的不可变核心并拒绝写入。完整模型见可写层。
关于名字。 Slater 以《Archer》(一部很棒的剧)中的 CIA 特工命名, 他坚持只用单名——"Just… Slater"——也是我最喜欢的 角色之一。参见 角色 wiki 页面。
MERGE / SET / DELETE,组提交且 fsync 持久,通过合并折回一个全新的核心。读取无需为此付出代价。current 指针,服务器便会拾取它。每个块都经过校验和验证,因此半拷贝的镜像会被拒绝而非被提供。| 特性 | 对您的意义 |
|---|---|
| 有界、可预测的内存 | 常驻内存跟踪的是您设置的三个缓存预算,误差在每项条目和分配器的有界开销之内——它不会随图规模增长;您调整的是性能/内存的权衡,而不是为整张图预留资源。带有后台清理的 jemalloc 分配器会在大量查询突发后把已释放的内存归还给操作系统,因此常驻内存会回落到空闲基线,而不是一直停留在突发后的高水位。 |
| 开箱即用的多租户 | 一台服务器托管多张图,并带有按用户的读取授权——这种多数据库隔离是大多数图数据库只在付费/企业版中才提供的。 |
| 静态与传输加密 | 按块进行 XChaCha20-Poly1305 密封(密钥从不写入磁盘),外加可选的 TLS(bolt+s://)。从设计上就符合 GDPR。加密同时也是获得经过认证的完整性的手段:构建器用带密钥的 MAC 密封清单,持有密钥的服务器会验证它,并拒绝提供清单被伪造、篡改或 MAC 被剥离的世代。无密钥(明文)镜像仅由无密钥的内容哈希保护——只能保证完整性和防损坏,不能防篡改。参见每种配置下完整性的含义。 |
| 极小的安装体积 | 一个基于 distroless glibc 的小型裁剪二进制文件(无 shell/apt)——多架构(amd64/arm64)镜像拉取约 22 MB,仅服务端的 slater:latest-lite 标签约 12 MB;纯 Rust TLS,无 OpenSSL。拉取即可运行。 |
| 为周期性发布而构建 | 离线构建图,以不可变方式提供服务,然后以零停机时间原子地换入新版本——非常适合数据仓库/定时刷新类工作负载。 |
| 高负载下依然稳健 | 服务器和离线构建器都以 #![forbid(unsafe_code)] 编译——引擎中唯一的 unsafe 位于经过审计的 jemalloc 分配器 crate 中。核心是不可变的,因此读取无需加锁,也从不等待写入者;单个写入者仅在写入路径上串行化变更。没有 GC 停顿,没有数据竞争。一个糟糕的查询不会拖垮服务器。 |
| 兼容您的 neo4j 工具 | 支持 Bolt 5.4 / 4.4 / 4.1——可原样使用标准 neo4j 驱动(JS、Python、Go、Java……)、cypher-shell 或图浏览器。 |
| 丰富的 Cypher 查询能力 | 广泛的读取能力:MATCH/WHERE/WITH/UNION、CALL {…} 子查询、70+ 函数与聚合、时间与地理空间值,以及正则表达式。 |
| 实时、持久的写入 | 在不可变核心之上可选启用的单写入者 LSM 层(delta.enabled):对节点和关系进行基于业务键的 MERGE / SET / DELETE / CREATE / REMOVE、批量写入 UNWIND(每批一次 fsync),以及 CALL slater.consolidate()——组提交、fsync 持久化,并通过合并折回新的核心。当 delta 为空时,读取路径字节级完全一致。 |
| ISO GQL,读写皆可 | 在同一 Bolt 连接上支持 ISO GQL(ISO/IEC 39075)的一个子集——量化路径、路径限制符、最短路径选择器、标签/类型布尔表达式、FOR、CAST、可选的 GQL/CYPHER 方言前缀——并且,在启用可写层后,GQL 的数据修改语句(INSERT / SET / REMOVE / [DETACH] DELETE)会落到同一条持久写入路径上。Cypher 与 GQL,读与写,尽在一个引擎中。 |
| 向量 + 图,一个引擎 | 磁盘原生的 ANN 向量搜索(Vamana + PQ;余弦 / L2 / 点积)用于嵌入/RAG,外加图算法(PageRank、BFS、介数中心性、WCC……)——即使有数百万个向量,内存也有界。嵌入是可写的(FreshDiskANN 风格的写入阶梯):插入 / 更新 / 删除向量,立即对 KNN 可见,无需重建即可折入基础数据。 |
| 在网络存储上安全 | 每个文件都经过 BLAKE3 内容哈希,并在打开时验证;撕裂或复制不完整的镜像会被拒绝,而不是被提供。专为 NFS/远程卷设计(没有 mmap 意外)。 |
| 可插拔存储后端 | 从本地文件系统、S3(兼容 S3)存储桶或 Google Cloud Storage 存储桶提供相同的生成格式——一次发布,分发到无状态副本——并可在对象存储前配置可选的本地 SSD 缓存层。参见存储后端。 |
该工作区由两个二进制文件组成:
| 二进制文件 | 角色 |
|---|---|
slater | 在线 Bolt 服务器(容器 ENTRYPOINT):提供读取服务,并在启用 delta.enabled 时提供单写入者持久写入路径。 |
slater-build | 离线编译器:将 primitive-Cypher 转储转换为不可变、内容哈希的 generation 目录。 |
Slater 将批量构建与服务分离:slater-build 在离线状态下完成繁重工作——摄取你的数据并将其编译为不可变的 generation——因此冷图永远不会在服务热路径上被组装。在服务器内部,读取接口可应答广泛的 Cypher 子集——模式匹配、WITH/UNION/CALL {…} 子查询、70+ 标量与聚合函数、时间与地理空间值、图算法(algo.*),以及磁盘原生向量 KNN(db.idx.vector.queryNodes)——而可写层的 delta 覆盖层位于该接口之下,为空时零开销,因此读取永远不会携带写入侧机制。你可以通过两种方式更新图:通过 Bolt 实时写入(参见可写层),或离线构建新的 generation 并原子交换 current 指针,运行中的服务器会通过其 generation 守卫拾取该变更(参见Generation 守卫)。
完整的用户手册位于 docs/manual/——这是一份逐功能指南,针对每项能力说明它是什么、为何存在以及如何使用,并附有可针对捆绑示例图运行的完整示例。除本概述之外的任何内容,请从那里开始。