比没有文档更糟糕的是什么？文档过时。没有文档你会自己试图通过其它途径把事情搞清楚，而过时的文档则会误导你。如何才能保持文档与代码/数据库结构同步？寄希望于开发人员自己去维护文档？估计难度仅小于中国难猪拿世界杯。怎么办？自动生成文档。程序员写软件不是为了帮用户提高工作效率，当然也能用工具解决自己的问题。SchemaSpy就是这样一个能从数据库Schema自动生成文档的工具。
博客园上有篇文章《用SchemaSpy制作数据库文档》讲的很仔细，我就不赘述了。下面讲一讲我使用中遇到的几个问题：
1 微软官方的JDBC和SQL Server搭配的时候会出问题，对Variant的数据类型支持不好，建议使用JTDS,详情请见这篇文章 《Database Documentation Using SchemaSpy》
2 SchemaSpy中用于抽取SQLServer schema的SQL语句和SQL Server2005不兼容，需要修改一下。原来的SQL语句在mssql.properties中，里面用到的sysproperties表在SQLServer2005中已经不存在了，被sys.extended_properties表替代，同时列名也有改动。详细内容可以参照这篇文章《简单的3个SQL视图搞定所有SqlServer数据库字典》
3 SchemaSpy生成的文档默认是ISO-8859-1,中文显示就是乱码,需要制定参数-charset UTF-8.诡异的是schemaspy的help和主页上的用法都没有提到这一点,俺是在源码里找到这个选项的.原来这就是开源的好处啊.