Click here to Skip to main content
Click here to Skip to main content

SQLDoc Sharp

By , 23 Apr 2009
 

Introduction

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

It allows you to export documentation to CHM format (Microsoft Compiled HTML Help).
It is also easy and interactive, which allows multiple database documentation.
For more details, please refer to http://www.amitchaudhary.com/.

Background

Finding the answer to, "Is there any free tool for generating documentation from SQL 2005/2008".

Using the Code

After running the application, 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:

  1. Source: Instance Name of the SQL Server 2005/2008 
  2. If want to connect with SQL authentication then:
    1. User Name: Name of the user whose credentials you want to use
    2. Password: Password of the user whose credentials you want to use
  3. In case, to connect with Windows authentication then, only check the checkbox   (Integrated Security) and your 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, you then choose to export the metadata/documentation in the XML format too.

Step # 3

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

After making the selection the SQLDoc Sharp, the 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 

Points of Interest

At the time of writing the application, I got the opportunity to explore the SQL Server Metadata functions, stored procedures, etc. I also explored ADO.NET GetSchema, MetaCollections, etc. 

License

This article, along with any associated source code and files, is licensed under The Common Public License Version 1.0 (CPL)

About the Author

Amit Chaudhary
Architect
India India
Member
An engineer with approx. 8 years of excellent experience in middle tier applications, analysis, design, development, testing, and maintenance of various client server/web based applications. Has the ability to handle multiple task(s), work independently as well as in team. Motivated, energetic with demonstrated proficiency for learning new technologies and business environments to provide effective and efficient IT solution(s) that envisage a futuristic approach with distributed and object oriented technologies.

Sign Up to vote   Poor Excellent
Add a reason or comment to your vote: x
Votes of 3 or less require a comment

Comments and Discussions

 
Hint: For improved responsiveness ensure Javascript is enabled and choose 'Normal' from the Layout dropdown and hit 'Update'.
You must Sign In to use this message board.
Search this forum  
    Spacing  Noise  Layout  Per page   
QuestionNice project! Question about sortingmemberYves Rausch20 Jun '12 - 5:24 
Hello,
 
this is a very nice project. Finally a free stuff to implement in my documentation to modify on my own needs.
Talking about modify the code: I see that the chm files are compiled by the tables list. But the tables list in not sorted.
 
tables = Utility.DBConnection.GetSchema("Tables", restrictions);
 
With this you get the tables from the database. Do I have any chance to sort them with fetching them from the database?
AnswerRe: Nice project! Question about sortingmemberYves Rausch20 Jun '12 - 21:27 
QuestionPre compiled versionmemberMember 885235719 Apr '12 - 7:12 
QuestionWon't compile under VS2010membersoulfiremage13 Mar '12 - 1:17 
AnswerRe: Won't compile under VS2010memberbwtraz20 Mar '12 - 8:19 
GeneralIt worksmember99sayegh6 Mar '11 - 17:08 
GeneralCheck/Uncheck/Toggle buttons and Check boxesmemberScotDance12 Jan '10 - 4:02 
GeneralTested against Northwind (small db) Just hangs the machine, also have to set chm path to same as exe [modified]memberjohn blox29 Sep '09 - 3:01 
GeneralRe: Tested against Northwind (small db) Just hangs the machine, also have to set chm path to same as exememberHanant11 Oct '09 - 8:18 
GeneralExcel, Pdf or XMLmemberAmit Chaudhary6 Aug '09 - 19:34 
GeneralAgain it hangsmembersore_ron15 May '09 - 3:51 
AnswerRe: Again it hangsmemberAmit Chaudhary17 May '09 - 20:01 
QuestionUnable to read CHM page with non-English object namememberdoggy_epaper.tw10 May '09 - 8:19 
GeneralMy vote of 1memberpita200922 Apr '09 - 7:14 
AnswerRe: My vote of 1memberAmit Chaudhary25 Apr '09 - 7:40 
GeneralSQL Doc sharpmemberwkww200422 Apr '09 - 4:08 
AnswerRe: SQL Doc sharpmemberAmit Chaudhary25 Apr '09 - 7:41 
Questionit didn't workmembermahmola22 Apr '09 - 3:42 
AnswerRe: it didn't workmembersmesser22 Apr '09 - 9:39 
AnswerRe: it didn't workmemberAmit Chaudhary25 Apr '09 - 7:41 
GeneralRe: it didn't workmembersmesser25 Apr '09 - 12:00 
Questiongood but ...memberMember 461770122 Apr '09 - 3:16 
AnswerRe: good but ...memberAmit Chaudhary25 Apr '09 - 7:42 
GeneralGood, but ...memberPeni22 Apr '09 - 2:26 
AnswerRe: Good, but ...memberAmit Chaudhary22 Apr '09 - 2:27 
GeneralRe: Good, but ...memberHenry Minute22 Apr '09 - 3:17 
AnswerRe: Good, but ...memberAmit Chaudhary25 Apr '09 - 7:43 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Permalink | Advertise | Privacy | Mobile
Web01 | 2.6.130516.1 | Last Updated 24 Apr 2009
Article Copyright 2009 by Amit Chaudhary
Everything else Copyright © CodeProject, 1999-2013
Terms of Use
Layout: fixed | fluid