v0.1 发布说明#

v0.1 是 MuduDB 文档的初始版本,涵盖安装、SQL 使用、过程开发、包部署与架构。

文档于 2026-10-12 按 MuduDB 源码提交 614413db 核对,以 scuptio/mududb.document 的 c9451e7 为参考。这些内容描述该工作区的实现,不代表所有功能均已发布为二进制版本。

新特性#

  • SQL CRUD 支持:CREATE TABLE、INSERT、UPDATE、DELETE 以及带谓词与表达式的 SELECT。

  • Mudu 过程模型:使用 Rust、AssemblyScript、C、C#、Go 或 Python 编写存储过程,以 .mpk 包部署,并通过 mcli 调用。

  • MPK 打包:将 WebAssembly 组件、DDL、描述符与初始化数据打包为基于 ZIP 的 .mpk 归档。

  • 多模式服务端后端:在 mudud.cfg 中选择 Legacy、IOUring 或 Tokio 执行模式。

  • 每核工作线程模型:内核管理的工作线程,通过分区本地所有权减少跨核争用。

  • RANGE 分区:定义全局分区规则、将表绑定到规则,并将分区放置到指定工作线程。

  • 格式契约:page header、tuple binary format、log frame、protocol frame、MPK manifest、server config、file layout、syscall payload 的正式规范。

  • HTTP 管理 API:通过 mcli --http-addr 安装、列出、卸载应用以及查询拓扑。

  • 复制与 Raft 容错:单机 / 主从流复制(stream)/ Raft 共识(raft)三种部署形态;共享复制通道、快照与 WAL GC、在线成员变更(learner 两步法)、mcli repl 工具化的主从故障切换与 epoch fencing、GET /mudu/server/replication 可观测性端点。详见复制与 Raft 容错。

已知限制#

  • IOUring 后端路径在设计上以 KV 为优先方向;这是设计取向而非能力限制——SQL 与 KV 目前都可在该后端运行。

  • 跨多个工作线程的分布式两阶段提交尚未实现。跨 worker 写入会被转发到远程执行,但跨 worker 的完整原子提交尚不支持。

  • 不支持二级索引;查询依赖主键与范围扫描。

  • mudup 发布安装器目前仅是设计提案、尚未实现;开发请从源码构建。

迁移与兼容性#

  • v0.1 对所有磁盘格式与网络线格式使用格式版本 1。未来版本将提升这些版本号并提供离线迁移工具。

  • 配置文件使用 Server Configuration Contract 中描述的 v1 TOML schema。

接下来阅读#