使用SQL文件自动生成数据库文档

0x00 起因

来新公司实习刚过一周时间,一开始都在尝试看项目代码,数据库表结构等,因为没有完备的文档,所以看起来还是相当困难的,也是因为看数据库时,每次需要一张表一张表的翻,非常麻烦,就想着写个脚本通过SQL文件生成数据库文档,而且当前比较流行markdown,所以就为SQL文件生成了md格式的数据库文档,于是就有了该脚本。

0x01 脚本介绍

目录结构:

md/
FileParserClass.py
MarkdownBuildClass.py
build.py
README.md

其中生成的md文档将保存到md目录下.
FileParserClass.py文件实现从SQL文件中获取数据库表结构
MarkdownBuildClass.py文件为上面文件中获取到的数据库表结构加入md语法
build.py文件为运行文件,运行该文件,即可实现文档生成。
README.md为脚本使用说明。

0x02 使用实例

SQL文件图:

《使用SQL文件自动生成数据库文档》

生成的md文件图:

《使用SQL文件自动生成数据库文档》

解析后的文件图:

《使用SQL文件自动生成数据库文档》

0x03 GitHub 目录

传送门:https://github.com/2liang/AutoBuildDocFromDB

0x04 BUG反馈

因为我的测试SQL文件比较简单,而且测试的SQL文件比较少,难免其中出现问题,如有遇到BUG,还希望能够发我邮箱。邮箱:usntring@163.com

原文作者:我才是二亮
原文链接:http://www.2liang.me/archives/264
转载必须在正文中标注并保留原文链接、作者等信息。

[4]: https://github.com/2liang/AutoBuildDocFromDB
    原文作者:SQL
    原文地址: https://segmentfault.com/a/1190000004550692
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞