在我十几年的工作中，还没见过哪个程序员喜欢把自己的代码生成相应文档的。当然，数据库开发者也是一样，他们总是避免以文档形式记录自己的代码和结构，而当有其他人要接手他们的项目时，才会感到问题的严重性。养成记录代码的习惯并不容易，因为大部分开发者还是喜欢把东西记在自己的脑子里。

　　因此，我最近一直在寻找一个SQL Server文档工具，希望它能够帮助开发人员记录下自己的工作，不仅仅是为了他们自己，更是为了其他有可能接手他们工作的人，即便是一个设计完美的数据库，对于设计者之外的人来说也未必可以很直观地看懂。为此，我在这里想要介绍一款工具：Red Gate公司开发的SQL Doc，一款专门为SQL Server DBA和开发者设计的工具。

　　SQL Doc是一款简单实用的文档工具，它通过连接现有数据库(需要你提供服务器名和证书)，可以让管理员浏览其中的对象列表并添加存储在Description列中的对象详细资料。SQL Doc可以同SQL Server自有的结构密切协作，让管理员更轻松地添加描述数据。此外，它是一个非常小的程序，所以会比SSMS快很多。

　　SQL Doc有许多实用的功能，其中几乎数据库模式的每一个元素都能被标记出来。举例来说，点击一个对象，然后你可以看到它的主属性列表、它的列和参数、生成对象的原始SQL脚本以及对象用到的和被用到的相关信息。点击编辑按钮，就可以在弹出窗口中输入相关属性的描述。在编辑窗口中同样还有“上一个”、“下一个”选项，你可以直接点击选择需要编辑的属性从而避免了关闭窗口的动作。当一个对象的属性比较多的时候，这一功能是非常实用的。

　　SQL Doc可以收集这些属性并生产离线文档，这一功能至少占用了该程序的一半。比如，“生成文档”选项可以创建一个.doc文档、帮助文件或者一个网页。编译后的文档与你在程序中看到的十分接近，它不仅包括你编辑的描述，还包括了对象脚本等内容。

　　在我看来，SQL Doc为管理员生产数据库文档提供了一个方式，当然它还不能成为一个完美的文档解决方案，但是可以说是一个很好的开端。在价格方面，你可以下载14天的免费试用版本，之后继续使用的话，单一用户许可证的价格为295美元，而批量购买还可以享受更多的折扣。