《卓有成效的程序员》读书笔记二:使用SchemaSpy自动生成数据库文档
2009-04-25 06:30
639 查看
比没有文档更糟糕的是什么?文档过时。没有文档你会自己试图通过其它途径把事情搞清楚,而过时的文档则会误导你。如何才能保持文档与代码/数据库结构同步?寄希望于开发人员自己去维护文档?估计难度仅小于中国难猪拿世界杯。怎么办?自动生成文档。程序员写软件不是为了帮用户提高工作效率,当然也能用工具解决自己的问题。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和主页上的用法都没有提到这一点,俺是在源码里找到这个选项的.原来这就是开源的好处啊.
博客园上有篇文章《用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和主页上的用法都没有提到这一点,俺是在源码里找到这个选项的.原来这就是开源的好处啊.
相关文章推荐
- showdoc使用笔记(自动生成api文档和数据库字典)
- 使用SchemaSpy生成数据库文档
- 关于codesmith的一点使用--自动生成数据库中所有表的存储过程使用模板
- 使用ASP.NET自动生成数据库失败
- jsdoc注释规范工具(使用 JSDoc 3 自动生成 JavaScript API 文档)
- Xcode常用插件使用及自动生成帮助文档
- 关于使用SQL自动生成,程序转化工具,提高开发数据库的效率
- 自动生成数据库的说明文档
- 使用CodeSmith根据数据库中的表自动生成WinUI界面(使用TableLayoutPanel布局)的代码.
- 关于自动生成数据库的说明文档
- 关于序列的使用,数据库中以自动生成的方式进行保存
- 使用jacob生成数据库文档
- C#分析数据库结构,使用XSL模板自动生成代码
- Eclipse使用自带插件JPA Tools实现自动生成数据库对应表的实体类(不使用Hibernate)
- C#分析数据库结构,使用XSL模板自动生成代码(一)
- 使用Sphinx为你的python模块自动生成文档
- C#分析数据库结构,使用XSL模板自动生成代码
- [导入]C#分析数据库结构,使用XSL模板自动生成代码
- 关于自动生成数据库的说明文档
- [技巧]使用Xcode集成的HeaderDoc自动生成注释和开发文档