WebAssembly 集成#
MuduDB 在 WASI 沙箱中运行用户过程 WebAssembly 组件。它在保持数据库访问受内核控制的同时,提供可移植性、隔离性与多语言支持。
组件模型#
MuduDB 过程被编译为面向 wasm32-wasip2 平台的 WebAssembly 组件。该组件导入少量宿主编译的系统调用,并导出标记为 /**mudu-proc**/ 的过程函数。
构建时,mtp 转译器生成组件的导入/导出接口:组件导入宿主系统调用接口(同步 world 为 mududb:api/system,异步 world 为 mududb:async-api/system),并为每个过程导出一个 mp2-<name> 入口点,与运行时加载器期望的签名相匹配。
WASI 沙箱#
过程在 WASI 沙箱中执行,具有以下特性:
数据库访问只能通过显式内核系统调用进行。
内核中介所有网络、文件与存储访问。
可按每次过程调用强制执行资源限制(内存、CPU、系统调用次数)。
语言支持#
运行时托管六种客户语言:Rust(主要过程语言)、AssemblyScript、C#、Python、C 和 Go。原则上,任何能生成 WASI 组件的语言未来都可支持。
语言 |
目标 |
说明 |
|---|---|---|
Rust |
|
主要支持语言;通过 |
AssemblyScript |
WASI 组件 |
通过 |
C# |
WASI 组件 |
使用 componentize-dotnet(.NET wasi-wasm 目标)构建。 |
Python |
WASI 组件 |
使用 componentize-py 构建; |
C |
WASI 组件 |
使用 wasi-sdk 的 clang 工具链构建。 |
Go |
WASI 组件 |
使用 TinyGo 构建。 |
客户绑定#
客户绑定由 mgen 根据 mudu_binding/wit/ 中的 WIT 接口定义生成,该目录是客户/宿主 ABI 的唯一事实来源。仓库内的 Rust 过程通过 sys_interface 与 mududb SDK 门面使用这些绑定;每种客户语言各自携带生成的编解码器。
运行时限制#
运行时可对每次过程调用强制执行以下限制:
内存使用;
CPU 预算(fuel)与墙上时钟超时;
宿主调用(系统调用)次数;
输入与输出大小;
并发调用数(全局及每个应用)。
这些限制有助于将用户代码与内核及其他过程隔离。
包格式#
编译后的组件与 DDL、描述符及可选初始化数据一起打包为 .mpk 归档。详见应用包与 MPK 清单契约。
配置解析器接受 p3,但当前过程导出名选择对 P3 返回 NotImplemented。本文的过程调用路径应使用 component_target = "p2"。