73 lines
4.5 KiB
Markdown
73 lines
4.5 KiB
Markdown
# ChuSQL
|
||
|
||
本项目是一个简单的数据库项目，服务端采用Haskell和Rust联合编写，采取B/S模式，管理客户端运行在浏览器网页上。
|
||
|
||
## 仓库布局
|
||
|
||
| 目录 | 语言 | 组件 |
|
||
| ----------------- | -------------------------- | ----------------------------------------------------------------- |
|
||
| `chusql-engine/` | Haskell | 执行引擎：词法分析与AST、表达式求值、关系代数、内存表、服务端接口 |
|
||
| `chusql-storage/` | Rust | 存储引擎：磁盘IO、B+树、缓冲池、WAL、崩溃恢复、并发控制 |
|
||
| `chusql-web/` | Haskell + React/TypeScript | Web 管理端：Scotty REST API + VS Code Dark+ 风格数据库 Web IDE |
|
||
| `script/` | PowerShell | `chusql.ps1` / `chusql.cmd`：一键启动 / 子命令 / 设置管理 |
|
||
| `docs/` | Markdown | 设计长文：ENGINE_INTRO / STORAGE_INTRO / WEB_SPEC |
|
||
|
||
# 架构分层
|
||
|
||
## Haskell部分
|
||
|
||
作为函数式编程语言，从语言层面契合SQL语句解析和代数数学运算，同时有强大的类型安全系统。
|
||
|
||
- SQL词法分析、AST
|
||
- 语义分析：表/列存在性与类型检查（执行前的关卡）
|
||
- 事务处理
|
||
- 查询优化、内存表管理
|
||
- 关系代数运算
|
||
- 服务端接口与请求相应
|
||
- Web 管理端：Scotty REST API、登录会话、静态页面交付
|
||
|
||
## Rust部分
|
||
|
||
高性能、内存安全且具有强大并行异步编程能力的现代编程语言。
|
||
|
||
- 磁盘IO
|
||
- B+树、页面管理
|
||
- 缓冲池
|
||
- WAL
|
||
- 事务日志和崩溃恢复
|
||
- 并发控制
|
||
|
||
# 配置
|
||
|
||
服务端与前端各有一份配置文件，互不影响：
|
||
|
||
| 文件 | 归属 | 内容 | 读写方式 |
|
||
| ------------------------------- | ------------------ | ------------------------------------------------------------------------ | ---------------------------------------- |
|
||
| `script/chusql.settings.json` | chusql-web 服务端 | 端口、监听地址、会话、限流、分页上限、账号、存储进程参数 | `chusql.ps1 config set`、`/api/settings` |
|
||
| `script/chusql.ui.settings.json`| 前端 IDE（浏览器） | 字体链、字号、行高、Tab 宽度、分页大小、NULL 文本、自动补全、Minimap 等 | `GET` / `PUT /api/ui-settings` |
|
||
|
||
服务端配置的优先级是 `命令行 > 设置文件 > 环境变量 > 内置默认`；前端配置只有设置文件与内置默认两层。
|
||
|
||
前端配置由 chusql-web 负责落盘，**不经过 Rust 存储进程**，也不写进 `chusql-storage.toml`。前端在本地
|
||
`localStorage` 留一份缓存，后端不可用时（例如开发用的 MockAdapter）自动回退到本地，行为与没有这份配置时一致。
|
||
|
||
两份文件都是本机专用、不入库（见 `.gitignore`）。`chusql-web/static/` 是 vite 构建产物，同样不入库，
|
||
需要时在 `chusql-web/frontend` 下跑 `npm run build` 生成；缺失时依赖它的构建产物契约测试会记为 pending。
|
||
|
||
# 性能基准
|
||
|
||
| 指标 | 200 × 200 | 500 × 500 | 1000 × 1000 |
|
||
| ------------------------------------------------ | --------: | --------: | ------------------: |
|
||
| 单条 `INSERT`（整条语句） | 2.66 ms | 2.86 ms | 2.88 ms |
|
||
| 同一条 `INSERT`（原始 IPC，不经引擎） | 2.50 ms | 2.85 ms | 2.77 ms |
|
||
| **多行 `INSERT`（100 行/条）** | — | — | **0.059 ms/行** |
|
||
| `SELECT * FROM users` | 0.4 ms | 1.0 ms | 1.9 ms |
|
||
| `SELECT name FROM users WHERE age > 90` | 0.3 ms | 0.8 ms | 2.7 ms |
|
||
| `SELECT ... JOIN ... WHERE` | 0.9 ms | 2.4 ms | 5.3 ms |
|
||
| `SELECT name FROM users WHERE id = k` | 0.2 ms | 0.2 ms | 0.2 ms |
|
||
| `DELETE FROM users WHERE id = k`（删 1 行） | — | — | 4.8 ms |
|
||
| `DELETE FROM users`（删全部 1000 行） | — | — | 20.2 ms |
|
||
| `SELECT ... WHERE code = k`（无索引 → 建索引后） | — | — | 1.8 ms → **0.2 ms** |
|
||
|
||
> 最近更新：2026-09-26
|