利用node.js制作MySQL表结构文档

对于一个项目来说,数据库表结构的设计是比较重要的一环。从程序开发的流程上来说,应该先设计表再着手进行开发。不过随着技术的发展,很多后端语言都有表结构的映射了。因此,对于表结构的设计就转变成了类结构的设计了。这么做无疑是节省了人工成本,但带来的负面影响是没有以前设计流程中的表结构的文档了。

在最近的一个项目中,恰好就遇见了需要表结构文档的情况。虽说可以直接看类定义,但是这样毕竟不是最直观的。不过要对着类定义来做文档,又很花费精力,同时文档与代码的同步性也是一个很严重的问题。在上家公司由于文档往往都是有延迟或者间隔的,导致一旦发生什么,就只能对着源码来工作。

所以对应着这样的需求,自然就有了制作相关小工具的想法了。主要的需求就是——生成比较容易阅读的表结构文档。

作为一个坚定的JS爱好者,二话不说就拿着Node上了。因为后端在做映射的时候肯定会生成建表的SQL,那么我只要对这SQL进行解析的就完事了嘛~但是转念一想,解析SQL文件根本就没必要啊!既然是拿表的结构,那么直接从数据库里面拿不就好了嘛!

整体的流程大致如下:

  1. 连接MySQL,执行相关SQL语句
  2. 把SQL获取到的结果按照对应的格式输出成文档(表结构与索引相关信息)

为此我们需要下面几个库来帮我们

  1. mysql 用于连接MySQL以及执行相关SQL语句
  2. xlsx 用于导出Excel
  3. async 用于执行批量操作

逻辑并不是很复杂,而且这些库相信很多同学也都用过,所以也就不在这里展开了。
还是老样子,先来看看整体的实现效果。


example.png

执行npm run start就会生成出含有表结构以及索引相关信息的Excel文档了。

  • 没有样式是因为xlsx没法对Excel的单元格进行编辑。不过相比起手工做表结构,添加一点样式的工作量应该是少很多了。

目前生成出的字段都是我根据自己目前项目需要所抽取的,各位也可以根据自己的需要来进行设置。
设置的方法可以查看项目的Readme。

项目地址在这里:mysql-doc
有不足和需要改进的地方也请各位多多指点,如果正好有帮上各位的忙也请不要吝啬点个赞呗~

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,616评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,020评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,078评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,040评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,154评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,265评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,298评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,072评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,491评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,795评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,970评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,654评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,272评论 3 318
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,985评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,223评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,815评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,852评论 2 351

推荐阅读更多精彩内容