为啥要写这个脚本
五一前的准备下班的时候,看到同事为了做数据库的某个表的数据字典,在做一个复杂的人工操作,就是一个字段一个字段的纯手撸,那速度可想而知是多么的折磨和锻炼人的意志和耐心,反正就是很耗时又费力的活,关键是工作效率太低了,于是就网上查了一下,能否有在线工具可用,但是并没有找到理想和如意的,于是吧,就干脆自己撸一个,一劳永逸,说干就干的那种……
先屡一下脚本思路
第一步:输入或修改数据库连接配置信息,以及输入数据表名
第二步:利用pymysql模块连接数据库,并判断数据表是否存在
第三步:获取数据表的注释
第四步:存储文件夹和文件处理,删除已存在的文件避免重复写入
第五步:先写入Markdown的表头部信息
第六步:从information_schema中查询表结构和相关信息
第七步:依次拼装每个字段的Markdown文本写入,结束并关闭相关连接
运行环境
Python运行环境:Windows + python3.6
用到的模块:pymysql、os、time、pyinstaller
如未安装的模块,请使用pip instatll xxxxxx
进行安装,例如:pip install pyinstaller
获取数据库连接信息的两种方式
既然是要做数据字典,那么肯定就需要先连接数据库,而连接数据库,自然就需要先知道数据库的基本信息:IP地址、用户名、登录密码、数据库名等……
为了方便,我这里写了两种配置MySQL连接的方法:第一种是直接配置在代码里,直接修改代码里的连接信息就可以了;另外一种就是通过手动输入链接信息,不用修改代码,方便快速多用。具体的完整源码,我都上传到同性交友网站GitHub了,可以点下面的链接查看……
- 修改代码的完整源码:data_dict_config.py
- 手动输入的完整源码:data_dict_input.py
执行效果图
执行data_dict_config.py脚本的时候,交互效果如下
执行data_dict_input.py脚本的时候,交互效果如下
执行完脚本后,会在当前目录下,生成一个mysql_dict
文件夹,打开文件夹,里面的.md
格式的文件就是每个表的markdown
文本的表格写法,拷贝里面的文本到任何支持mardkwon
地方就可以使用和查看,例如我放到有道云笔记上,部分效果如下
生成可执行文件
为了方便不同的人群方便快速的使用,可以不用安装Python环境来执行py脚本文件,我把相关脚本打包成Windows可直接执行的exe文件,下载双击运行即可(可能有的系统需要管理员权限运行),打包的方式很简单,就是利用pyinstaller
模块进行快速打包,省时省力,具体更多用法大家可以网上查一下。
打包命令为:pyinstaller -F -i favicon.ico data_dict_input.py
执行这个命令后,就会在当前目录下生成一个dict
和其他的文件夹和相关文件,其中,打开dict
,下面会生成一个文件名相同的exe文件data_dict_input.exe
,双击这个文件就可以打开了,拷贝到其他地方一样可以使用。
下面我把两种方式的脚本,都生成了exe可执行文件,大家可以直接点击下载试用,如果下载不了,请直接去GitHub仓库下载或者自己生成
修改代码的可执行文件:data_dict_config.exe
手动输入的可执行文件:data_dict_input.exe
完整代码
为了方便部分人想偷懒,不直接去交友网站查看,我在这里也贴一下其中的一个源码出来吧(其实吧,我是觉得文章篇幅有点短,来凑字数的,大家明白就好,看透不说透)。
1 | #!/usr/bin/env python |
最后
老规矩,大家有任何问题,都可以留言或者各种渠道告诉我,虽然我可能也不会去修改。方法和思路万千,如果你有其他思路以及想法的,欢迎留言分享和交流……