VillageSQL is a drop-in replacement for MySQL with extensions.
All examples on this page work on VillageSQL. Install Now →
villagesql crate 以 Rust 编写。SDK 处理所有 FFI 编组 — 您编写普通的 Rust 代码,extension! 宏会生成服务器在加载时调用的 C 入口点。
何时选择 Rust
在以下情况下,Rust 是正确的选择:- 您更喜欢 Rust,并且不需要 C++ 代码库
- 您想要内存安全,但不想要垃圾回收器
- 您正在构建一个新扩展,并且没有现有的 C++ 依赖
先决条件
您需要:- Rust stable 工具链 — 从 rustup.rs 安装
- cargo-vsql — 用于打包、安装和测试的 Cargo 子命令
cargo-vsql:
创建新 Crate
创建一个库 crate,添加 SDK,然后进行配置:Cargo.toml 中设置 crate 类型:
Cargo.toml 旁边添加 manifest.json:
编写函数
用 Rust 构建扩展 页面提供了带有 ROT-13 示例的完整演练。简短版本:实现fn(&[InValue]) -> VdfReturn,用 func! 注册它,然后用 extension! 包装所有内容:
测试扩展
在mysql-test/t/basic.test 中编写测试:
[ pass ]。
在 SQL 中安装
打包并安装:另请参阅
- 用 Rust 构建扩展 — 带有 ROT-13 示例的完整演练、打包和测试细节
- Rust 中的自定义类型 — 定义带有二进制存储和排序的新列类型
- Rust API 参考 — InValue、VdfReturn 和所有宏
- 编写 C++ 扩展 — 完成同一任务的 C++ 路径