10分钟跑通一个数据库服务端：MiniOB 新手上手指南 [特殊字符]️-平芜编程栈

10分钟跑通一个数据库服务端：MiniOB 新手上手指南 🗄️

【免费下载链接】miniobMiniOB is a compact database that assists developers in understanding the fundamental workings of a database.项目地址: https://gitcode.com/GitHub_Trending/mi/miniob

MiniOB 是一款用 C++ 写的轻量级数据库，把 SQL 解析、查询执行、B+ 树索引、日志恢复这些内核环节做成了可读的源码。它适合想进内核层的学生和开发者，照着这篇走，大约 10 分钟能启动你的第一个 MiniOB 实例。

MiniOB 是什么：先看一张架构图

刚学数据库时，"服务端"三个字背后藏着太多东西：网络收发、SQL 解析、计划生成、存储读写。MiniOB 把它们全部摊开，而且只保留了理解原理必需的部分。

图中从上到下就是一条请求的旅程：客户端把 SQL 交给网络模块，经过解析和语义检查变成语法树，优化器改写后交给执行器，最后落到存储引擎，日志模块在旁边记录每一步。

MiniOB 怎么装：最短路径编译并启动

克隆仓库，然后初始化一次编译环境：

git clone https://gitcode.com/GitHub_Trending/mi/miniob cd miniob bash build.sh init

编译出调试版二进制，首次编译大约需要几分钟：

bash build.sh

启动服务端并直接进入命令行交互模式，不用客户端：

cd build_debug ./bin/observer -f ../etc/observer.ini -P cli

看到Welcome to the miniob.提示符就说明跑起来了。更细的配置项（日志级别、端口、buffer pool 大小）写在etc/observer.ini，用法详见仓库内的运行文档。

MiniOB 数据库内核怎么转：一条 SQL 的流水线

你输入的每条 SQL 都会走同一条流水线：解析器把字符串变成语法树，语义检查确认表和字段存在，优化器挑一个执行计划，执行器按计划向下要数据，存储引擎负责真正的读写。

可以把它想象成一条装配线：每个工位只干一件事，上一站的产物就是下一站的原料。想加新功能时，你只需要找到对应工位，而不是通读整个仓库。

10分钟小练习：建表、插数、查计划 💾

进入上面的 cli 模式后，依次执行：

create table t1 (id int primary key, name char(16)); insert into t1 values (1, 'a'), (2, 'b'), (3, 'c'); select * from t1; explain select * from t1 where id > 1; exit;

成功的标志：select返回刚插入的 3 行；explain打印出执行计划树，里面能看到 TableScan 算子。再create index idx on t1(id);重新 explain，观察计划是否改用索引扫描。用exit或 Ctrl+D 退出，数据目录默认在/tmp/miniob。

MiniOB 报错怎么办：高频踩坑速查

Q1：运行 observer 提示找不到动态链接库？

依赖默认装在仓库的deps/3rd/usr/local，不在默认查找路径里。在 build 目录里执行./bin/observer -h前先export LD_LIBRARY_PATH=$PWD/../deps/3rd/usr/local/lib:$LD_LIBRARY_PATH再启动。

Q2：bash build.sh init报 flex、bison 缺失？

先确认已装 cmake（3.13+）、gcc 11+ 或 clang 14+、flex 2.5+、bison 3.7+，版本要求详见仓库内的构建文档，缺哪个补哪个即可。

Q3：启动报端口被占用或找不到 6789 端口？

先用./bin/observer -p 6790换一个端口启动服务端，客户端同步改成./bin/obclient -p 6790。

下一步看什么

MiniOB 架构设计文档：逐个模块理解各组件的职责和边界
如何编译与运行：查 TCP、unix socket 等更多启动方式
B+ 树索引源码目录：对照上文流水线动手读实现
课程实验任务：按由浅入深的题目继续练手

跑通只是入口，MiniOB 真正的价值在于你可以随时拆开看每个工位内部的代码。

【免费下载链接】miniobMiniOB is a compact database that assists developers in understanding the fundamental workings of a database.项目地址: https://gitcode.com/GitHub_Trending/mi/miniob

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考