Wednesday, April 22, 2009

SQLDoc Sharp, an interactive tool for SQL documentation




Introduction


SQLDoc Sharp, an interactive tool designed to generate the SQL Server 2005/2008 documentation.


It allows exporting the documentation to CHM format (Microsoft Compiled HTML Help). And it is easy and interactive, also allows multiple database documentation.


How to use the product


After opening the product, the initial UI looks like below.


SQLDocSharp.png


Three steps required to generate the documentation.


Step # 1


In the top section provide the details about the SQL Server. It includes


a)      Source: Instance Name of the SQL Server 2005/2008


b)      If want to connect with SQL authentication then,


a.       User Name: Name of the user whose credentials, you want to use.


b.      Password: password of the user whose credentials, you want to use.


c)       In case, to connect with Windows authentication then,


a.       Only check the checkbox (Integrated Security) and you current windows credentials would be used to connect with the specified SQL Server Instance.


Step # 2


Choose the database name from the Database dropdown list, whose documentation you want to generate and then click on the Fetch button.


Meanwhile you can choose/change the File Name of the CHM file which would be generated. And also if required, then you choose to export the metadata/documentation in the XML format also.


Step # 3


Click on the Generate button. And locate the CHM file at the path specified.


After making the selection the SQLDoc Sharp UI should look like,


SQLDocSharp Step 2.png


 


Screen Shots of the Documentation generated


 


Index


Index.png



 


Instance Information


 


Instance Information.png


 



 


Date source Information


 


DataSource Information.png



 


Data Types


 


List of DataTypes.png



 


Users


 


List of Users.png



 


Tables


 


tables.png



 


Table Details


 


table details.png



 


Views


 


Views.png



 


Procedures


 


procedures.png



 


Functions


 


Functions.png



 


Triggers


 


Triggers.png



 


User Defined Data Types


 


UDDTs.png

1 comment:

Tarun said...

i really liked your tool... its quiet powerful on small DBs...

but for our DB.. it gives a connection timeout error.. for SQL connection... ours is a very huge database.

can you help me with the code?

About Me

हर वक्त कई चीज़ें करने का मन करता है। हर वक्त कुछ नहीं करने का मन करता है। ज़िंदगी के प्रति एक गंभीर इंसान हूं। पर खुद के प्रति गंभीर नहीं हूं। लिखने को मैं गंभीर विषय नहीं मानता हूं। तब बोलने को भी साहित्य की तरह गंभीर विषय की मान्यता देनी होगी। इसलिए मैं बोलने को लिखने से ज़्यादा महत्वपूर्ण मानता हूं । इस ब्लाग में जो कुछ भी लिखता हूं वो मेरे व्यक्तिगत विचार है । यहां लिखी गई बातों को मेरे काम से जोड़ कर न देखा जाए । वैसे यह बहुत मुश्किल काम है ।