写点什么

TiDB 源码系列之沉浸式编译 TiDB

  • 2022 年 4 月 12 日
  • 本文字数:1220 字

    阅读完需:约 4 分钟

1.背景

最近刚学习完 PCTP,对 TiDB 的各种读写有了粗略的了解,但是要想研究的更细节一些的东西,肯定离不开学习源码,学习源码的话大家可以参考官方的 TiDB 源码系列文章,但是官方的文章都是 18 年发的,可能会有些滞后,所以大家可以参考这个以及结合源码去学。TiDB源码系列解读文章官方源码解读博客地址然而学习源码肯定编译调试源码是最有效的学习途径,经过这几天的学习,以及请教开发大佬,成功编译了 TiDB,所以分享给对源码感兴趣的小伙伴。

2.准备工具

Goland白嫖款一个(30天)TiDB 最新款源码tar包一份Mac一台

3.源码下载

1.首先去 github 上下载源码:源码下载地址2.选择自己想要看的版本:这里我以最新的 5.4.0 版本为例。



3.解压 tar 包


#1.打开终端#2.到对应目录解压tar包tar -xzvf tidb-5.4.0.tar.gz#解压后就会得到一个文件夹
复制代码

4.编译软件下载配置

由于 TiDB 是使用的 go 语言编写的,所以我们使用goland进行编译。1.下载一个 30 天白嫖版,有能力的可以直接购买付费版(支持正版)下载地址:goland下载地址选择适合自己的电脑系统的进行下载:



2.安装完成之后选择对应打开的项目。



3.找到自己刚才解压的 TiDB 源码文件夹,打开



4.打开后可能会出现很多的报错(如下图),但是问题不大,基本都是因为没有安装 go 的相关 module 导致的。



所需的 gomodule 可以在代码中的下面文件看到,可以看到目前都是红色,说明缺少对应的 mod。



5.打开 goland 的设置,然后下载最新版的 goroot,就会安装所需的 module。



然后选择一个最新的版本下载就好。



然后在下面就会开始下载相关的依赖:



测试的时候发现只会下载一部分,所以剩下的缺少的可以点击图片中的从 github sync。



下载完成之后就会全部变绿,至此环境我们就配置好了。


5.编译过程

经过上面的步骤,基本一切环境已经就绪,接下来我们就可以自己编译 TiDB 数据库。1.但是会又有一个问题从哪开始运行?这里还是要借助我开始说的官方源码系列:如何学习TiDB源码作为一个非专业开发人员,只能借助官网提示去学习。从我上面的地址,大家可以看到 TiDB 源码文件对应什么,以及从哪里开始。



2.从上面我们可以从官方博客知道从 tidb-server/main.go 运行首先 main.go 里面的 var 就是我们系统的启动参数,大家可以修改对应的参数进行启动



然后下面找到 main 函数旁边的绿色按钮,大家可以选择 debug 模式或者直接运行,这里我选择 Debug 模式,可以看到更多的信息。



点击之后需要等待一会儿,屏幕下方会显示 compiling..编译完之后,大家就可以在 debug 栏看到对应的信息:可以看到[INFO] [server.go:246] ["server is running MySQL protocol"] [addr=0.0.0.0:4000]说明启动成功了。



3.去访问看看是否真正运行成功。可以看到 TiDB 服务已经在运行,使用 MySQL 命令行访问 TiDB,可以看到已经 O K,至此编译完成。


6.最后

运行成功后,大家后续就可以通过对不同的函数打断点,然后看自己的 SQL 会调用哪些代码中的哪些函数。函数的位置可以参考官方博客源码解析进行断点测试。


原文作者:@Jiawei 发表时间:2022/2/24

原文链接:https://tidb.io/blog/5be1e094

用户头像

TiDB 社区官网:https://tidb.io 2021.12.15 加入

TiDB 社区干货传送门是由 TiDB 社区中布道师组委会自发组织的 TiDB 社区优质内容对外宣布的栏目,旨在加深 TiDBer 之间的交流和学习。一起构建有爱、互助、共创共建的 TiDB 社区 https://tidb.io/ 。

评论

发布
暂无评论
TiDB源码系列之沉浸式编译TiDB_TiDB 社区干货传送门_InfoQ写作平台