在做项目的时候，客户或者合作的部门常常问研发要「数据库设计」。在古代，瀑布式开发的第一个阶段是做架构设计和写文档，所以这样的需求一般都能被「充分满足」。而在我们现在的项目节奏和迭代速度都很快，数据库的设计在项目初期经常也在变化，如何能够比较方便的文档化这些变更？
对开发团队内部来说，我个人觉得 Django 的 South 或者是 1.7 之后加入的Migration里面每次变更生成的 migration 文件就已经足够开发人员了解底层的设计发生了什么变化。
而对外提供的文档，主要是在更高层级进行设计的沟通，所以之前我们一般是通过django-extension里面的graph_models命令来生成简单的关系图：
# Create a PNG image file called my_project_visualized.png with application grouping
$ ./manage.py graph_models -a -g -o my_project_visualized.png
效果如下：
这里的图是通过graphviz来完成的，可以看到一般的了解也足够了，但是缺点主要是：
- 生成的关系图比较简陋
- 由于是图片，一旦表比较多浏览起来并不是那么灵活
使用schemaSpy
于是在新的项目里面本座选用了看起来更美好的schemaSpy，因为：
- 轻量但支持多种数据库（jdbc），针对 Django 的 test/stage/prod 环境都可以使用
- 功能非常强大，并且有命令行支持，可以集成到 CI
不过和大多数开源工具一样，它的文档也是乱糟糟的。以开发环境为例，我们一般使用 sqlite 作为数据库，要在 Mac 下面成功运行 schemaSpy 连接 sqlite，你需要：
- 下载最新的SchemaSpy jar包
- 下载最新的Xerial Sqlite JDBC jar包
sqlite-xerial.jar - 创建一个
sqlite-xerial.properties文件，内容如下：
# Use -dp to override.
description=SQLite
connectionSpec=jdbc:sqlite:<db>
db=database name
driver=org.sqlite.JDBC
#you may need to put the full path to the driver depending on your setup
driverPath=sqlite-jdbc-3.8.7.jar
selectTablesSql=.tables
- 运行命令：
java -jar schemaSpy_5.0.0.jar -t sqlite-xerial.properties -db ../src/default.db -o django-testbird -sso
会看到有warning，但是无需惊慌，我看了一下是 schemaSpy 的作者没有正确的处理[]。
集成到Sphinx
因为我们的项目都使用了 Jenkins 自动启动 Sphinx 来生成文档，所以理想的情况当然是：
- 修改 Django 下某个 app 的
models.py make migration生成 migrations 文件- 代码提交并 push 到 gitlab
- Jenkins 调用
django management command完成表结构的变更 - Jenkins 自动更新包括数据库设计在内的文档
要实现#5，最简单的办法是在 Sphinx 文档目录下的Makefile里面加一个target：
dbv:
java -jar schemaSpy_5.0.0.jar -t sqlite-xerial.properties -db ../src/default.db -o _db_virtualization/django-testproject -sso
然后在 Jenkins 调用的脚本里面加上make dbv就可以了。
