Click here to Skip to main content
15,881,588 members
Articles / Programming Languages / C#

SQLDoc Sharp

Rate me:
Please Sign up or sign in to vote.
3.91/5 (9 votes)
23 Apr 2009CPL2 min read 96.1K   3.4K   40   27
SQLDoc Sharp, an interactive tool designed to generate the SQL Server 2005/2008 documentation.

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)


Written By
Architect
India India
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.

Comments and Discussions

 
QuestionNice project! Question about sorting Pin
Yves Rausch20-Jun-12 5:24
Yves 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 sorting Pin
Yves Rausch20-Jun-12 21:27
Yves Rausch20-Jun-12 21:27 
QuestionPre compiled version Pin
Member 885235719-Apr-12 7:12
Member 885235719-Apr-12 7:12 
QuestionWon't compile under VS2010 Pin
soulfiremage13-Mar-12 1:17
soulfiremage13-Mar-12 1:17 
AnswerRe: Won't compile under VS2010 Pin
bwtraz20-Mar-12 8:19
bwtraz20-Mar-12 8:19 
GeneralIt works Pin
99sayegh6-Mar-11 17:08
99sayegh6-Mar-11 17:08 
GeneralCheck/Uncheck/Toggle buttons and Check boxes Pin
ScotDance12-Jan-10 4:02
ScotDance12-Jan-10 4:02 
GeneralTested against Northwind (small db) Just hangs the machine, also have to set chm path to same as exe [modified] Pin
john blox29-Sep-09 3:01
john blox29-Sep-09 3:01 
GeneralRe: Tested against Northwind (small db) Just hangs the machine, also have to set chm path to same as exe Pin
Hanant11-Oct-09 8:18
Hanant11-Oct-09 8:18 
GeneralExcel, Pdf or XML Pin
Amit Chaudhary6-Aug-09 19:34
Amit Chaudhary6-Aug-09 19:34 
GeneralAgain it hangs Pin
sore_ron15-May-09 3:51
sore_ron15-May-09 3:51 
AnswerRe: Again it hangs Pin
Amit Chaudhary17-May-09 20:01
Amit Chaudhary17-May-09 20:01 
QuestionUnable to read CHM page with non-English object name Pin
Will_保哥10-May-09 8:19
Will_保哥10-May-09 8:19 
GeneralMy vote of 1 Pin
eran202222-Apr-09 7:14
professionaleran202222-Apr-09 7:14 
AnswerRe: My vote of 1 Pin
Amit Chaudhary25-Apr-09 7:40
Amit Chaudhary25-Apr-09 7:40 
GeneralSQL Doc sharp Pin
koronx2004200422-Apr-09 4:08
koronx2004200422-Apr-09 4:08 
AnswerRe: SQL Doc sharp Pin
Amit Chaudhary25-Apr-09 7:41
Amit Chaudhary25-Apr-09 7:41 
Questionit didn't work Pin
MG.Karo22-Apr-09 3:42
MG.Karo22-Apr-09 3:42 
AnswerRe: it didn't work Pin
Steve Messer22-Apr-09 9:39
Steve Messer22-Apr-09 9:39 
AnswerRe: it didn't work Pin
Amit Chaudhary25-Apr-09 7:41
Amit Chaudhary25-Apr-09 7:41 
GeneralRe: it didn't work Pin
Steve Messer25-Apr-09 12:00
Steve Messer25-Apr-09 12:00 
Questiongood but ... Pin
Member 461770122-Apr-09 3:16
professionalMember 461770122-Apr-09 3:16 
AnswerRe: good but ... Pin
Amit Chaudhary25-Apr-09 7:42
Amit Chaudhary25-Apr-09 7:42 
GeneralGood, but ... Pin
Peni22-Apr-09 2:26
Peni22-Apr-09 2:26 
AnswerRe: Good, but ... Pin
Amit Chaudhary22-Apr-09 2:27
Amit Chaudhary22-Apr-09 2:27 

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

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.