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。