Click here to Skip to main content
15,881,380 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

 
GeneralRe: Good, but ... Pin
Henry Minute22-Apr-09 3:17
Henry Minute22-Apr-09 3:17 
AnswerRe: Good, but ... Pin
Amit Chaudhary25-Apr-09 7:43
Amit Chaudhary25-Apr-09 7:43 

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.