背景
项目开始时，数据库表设计是从概要设计到详细设计，再到数据库中的表结构，有一套完整的文档；
然而，随着项目的演进，需求的变更，导致数据库表结构发生了比较大的变化（加表，加字段，改类型等），对于大多数小公司的项目，由于项目管理流程的不规范，在这个时候大概率是数据库设计文档没有同步跟进而过时；
现在，问题来了，出于各种原因吧，需要提供当前数据库的设计文档（总不能一张张表、一个个字段去手写吧。。）；
那么，怎么从现有的数据库表自动导出一个相对比较整齐的word文档呢？
从网上看了下，有人提供了方案＼(☆o☆)／，可一键导出 MySQL 数据库设计为 .doc 文件，见参考地址；我这里在作者的基础上，实现一键导出 PostgreSQL 数据库设计为 .doc 文件。
效果
这里以开源物联网平台 jetlinks 项目的数据表为例进行 PostgreSQL 数据库设计的导出。
运行
MySQL 版作者的实现是写了一个 Controller ，提供了一个 RESTful 接口来生成文档，这里是在单元测试类中提供了一个方法：
运行
com.heartsuit.db2word.postgresql.service.impl.DataSourceDetailServiceImplTest 中的 toWord() 测试方法，可直接生成 .doc 文件。
参考SQL
- 查询所有表名
select relname as table_name,(select description from pg_description where objoid=oid and objsubid=0) as table_comment from pg_class where relkind ='r' and relname NOT LIKE 'pg%' AND relname NOT LIKE 'sql_%' order by table_name;
- 查询每个表的字段信息
select a.attname as 字段名称, format_type(a.atttypid,a.atttypmod) as 类型, (case when atttypmod-4>0 then atttypmod-4 else 0 end) as 长度, (case when (select count(*) from pg_constraint where conrelid = a.attrelid and conkey[1]=attnum and contype='p')>0 then 'PRI' when (select count(*) from pg_constraint where conrelid = a.attrelid and conkey[1]=attnum and contype='u')>0 then 'UNI' when (select count(*) from pg_constraint where conrelid = a.attrelid and conkey[1]=attnum and contype='f')>0 then 'FRI' else '' end) as 索引, (case when a.attnotnull=true then 'NO' else 'YES' end) as 允许为空, col_description(a.attrelid,a.attnum) as 说明 from pg_attribute a where attstattarget=-1 and attrelid = (select oid from pg_class where relname ='ok');
源码
共三个分支
- mysql：将
MySQL数据表结构导出为word（基本上原作者的代码）。 - postgresql：将PostgreSQL数据表结构导出为
word。 - combined： 通过多数据源方式，动态切换
MySQL与PostgreSQL。
Note：
- 如果只是使用这个工具生成数据库设计文档，时间紧迫，则可直接使用
mysql或者postgresql分支； - 如果想了解下多数据源配置，动态切换数据源，则可以切到
combined分支。
postgresql分支代码
该分支基于原作者的代码，实现了将 PostgreSQL 数据表结构导出为word的功能。
- 作为一个小工具来实现，为避免引入复杂性（
MySQL与PostgreSQL多数据源），这里直接单独建了一个项目； .doc生成地址也硬编码在代码中：D:/data/dbDetail.doc（DataSourceDetailServiceImpl.toWord方法）；
Source Code
Reference
If you have any questions or any bugs are found, please feel free to contact me.
Your comments and suggestions are welcome!
