MSSql JDBC Driver

This article will explain what are JDBC drivers, how to download the MSSql JDBC driver and how to connect to MSSql using DbSchema Free Database Designer.

What are JDBC Drivers?

JDBC drivers are Java library files with the extension .jar used by all Java applications to connect to the database. Usually, they are provided by the same company which implemented the MSSql software. DbSchema Tool already includes an MSSql driver, which is automatically downloaded when you connect to MSSql.

What is the JDBC URL?

Each JDBC driver is using a specific URL. The URL is a string (text) with a specific format, containing information about the host where the database is running, the port, username, database name, etc. The format is specific to each driver. Any wrong character in the URL may make the database connectivity fail, therefore we recommend installing DbSchema and try to get connected. Then you can find the right URL directly in the DbSchema connection dialog.

Driver Information

DbSchema can connect to Azure Cloud database ! Just connect using host '', port 1433 and configured user and password.

We support all versions of SqlServer including SqlServer 2014, under the name 'SqlServer'. For SqlServer 2000-2005 we have created a different entry in DbSchema because of compatibility problems with the versions after.

  • Required File(s): sqlserver.jar
  • Java Driver Class:
  • URL: jdbc:sqlserver://{HOST}:{PORT};databaseName={DB}
  • Website: Microsoft

jTDS JDBC Driver

Download the file, unzip it and then load the jtds.jar file
  • Required File(s): jtds-1.2.2.jar
  • Java Driver Class: net.sourceforge.jtds.jdbc.Driver
  • URL: jdbc:jtds:sqlserver://{HOST}[:{PORT}][/{DB}];user={USER};password={PASSWORD}[;instance={PARAM}] or jdbc:jtds:sqlserver://{HOST}[:{PORT}][/{DB}];domain={PARAM};integratedSecurity=true
  • Website: jTDS web site
Watch a You Tube video How to configure SqlServer 2008 for jdbc connections.

Download MsSql JDBC Driver

The driver files are compressed in a zip file.

for any issues with the driver, you can write to us.

How to enable TCP/IP Connection and Set The Port

SqlServer TCP/IP connections are not enabled by default. You won't be able to connect to the database unless you enable them.

In the SQLServer Configuration Manager go to Protocols and enable TCP/IP
Click on the protocols for SqlExpress, right-click on the TCP/IP and choose Properties.
Go to the IP Addresses tab, scroll to the bottom and you'll find the option IP All enter the desired port by default it should be 1433.

Enable Database Authentication (Mixed Mode)

By default only the Windows Authentication is enabled. This will allow login on the database only using the COMPUTER_DOMAIN/WINDOWS_USER and not using the 'sa' user. Read the chapter about how to install SqlServer for details.

To be able to connect to the database using the 'sa' user or other database user, the mixed authentication mode should be enabled.

Take this steps to enable mixed mode authentication:

First, login to your server. Click on Start > Programs > Microsoft SQL Server Select "SQL Server Management Studio Express" / "SQL Server Management Studio", depending on your version of SQL Server.

Right click the server name and select "Properties". Click "Security".
SQL Server 3

A dialog will open. Under "Server authentication" select "SQL Server and Windows Authentication Mode".

Right click the server name and select "Restart". Wait a few moments for the service to restart before proceeding.
SQL Server 4
To review the current configured authentication method, from the previous dialog 'Server Properties' choose the 'View Connection Properties' in the bottom. In the Properties Dialog the configured authentication will show up.
SQL Server 5

Debug Connectivity Issues

  1. Check Network:
    Make sure the Network is workable and stable when you connect to SQL Server on a remote machine. You can test the Network connection using the PING grogram: ping <Server Name>
  2. Enable remote connections for SQL Server:
    a) In SQL Server Configuration Manager, expand SQL Server Network Configuration, and then click Protocols for .
    b) In the details pane, right-click one of the available protocols, and then click Properties.
    c) To enable the TCP/IP protocol (or named pipes) for remote connections, set the Enabled box to Yes.
  3. Enable the SQL Server Browser service:
    If you connect to a named instance, make sure the SQL Server Browser service by using SQL Server Configuration Manager is enable or specify the TCP port when connecting to it.
  4. Create an exception for SQL Server in Windows Firewall:
    If firewall is enabled on the server, you need to put TCP port number of the instance, such as 1433 for the default instance. Then add UDP 1434 for SQL Server Browser Service.
For TCP / IP connectivity problem troubleshooting process as below, please follow the steps.
  1. Check the server name you used.
    For a named instance, you need to type computer name\instance name. For a default server, you only need to type computer name. For server Configuration, please use netstat command. Run “netstat -an”command in DOS windows. The "netstat-an" command output in the removal of the part of the SQL Server port number as following: Active Connections Proto Local Address Foreign Address State TCP LISTENING TCP ESTABLISHED
  2. Client TCP/IP configuration
    In most cases you do not need to configure the client, because the TCP / IP protocol is enabled by default. You can use the Client Network Utility (or SQL Server Configuration Manger) to configure TCP / IP protocol. Run cliconfg.exe or from Start -> Programs -> Microsoft SQL Server -> Client Network Utility can be transferred out
  3. Verify that SQL Server is actually listening for TCP / IP protocol
    In order to verify that SQL Server does monitor the TCP / IP protocol, but also need to see the SQL Server errorlog file. If you find that SQL Server does not listen for TCP / IP protocol, use the server-side network configuration tool (run svrnetcn.exe ) to confirm whether the configured SQL Server monitor TCP / IP protocol.
  4. Check the network connectivity.
    To ensure that only the server can ping the IP address of SQL Server, SQL Server can ping the server name. If you ping the server name in question, indicating the DNS or WINS server configuration problem, you can in your HOSTS file (HOSTS file in the system32 \ drivers \ etc directory) and manually add server IP address as follows: MySQLserver If you have a problem with ping IP address, then check the configuration of the network including hardware connections. On the server and client are using "ipconfig / all" command to check the server and client are on the same network.
  5. Use the TELNET command to check the SQL listening port.
    To verify that SQL Server listening port, you can use the TELNET command. Assume that SQL Server's IP address is, port 1234, you can run the following command: TELNET 1234 If the TELNET successful, then the result will be a only a black screen with cursor in flash. If unsuccessful, then you will get an error message. These error messages need to continue troubleshooting the issue. From the remote machine can you telnet to SQL server on the port SQL server is running. On remote machine, open command prompt and type: telnet SQLServerHostName is either IP address or hostname of the remote computer where SQL serve is running PortNumber is port number SQL server is listening for default instance it is 1433 but check SQL server configuration manager to make sure.
  6. Check the SQL Server login user access.
  7. You can try to specify protocol and port to connect SQL Server in the Query Analyzer as below:
    TCP:MySQLServer,1433 Through this method can force the specified query analyzer using the TCP / IP connection to the server specified port.
  8. If it does not work for you, please try to use Network Monitor to capture trace to analysis.
    For more information about Network Monitor, please refer to this article
Additional, please refer the articles as below:
  1. TCP/IP port numbers required to communicate to SQL over a firewall:
  2. How to Troubleshoot Basic TCP/IP Problems:

Connect to MSSql using DbSchema Free Edition

Installing DbSchema Free edition will help to test the database connectivity and the JDBC driver URL.

Free Download DbSchema

When the download finished please follow this steps:

  1. 1 Select an Alias for your database connection. This will be the name of this specific connection to the database.
  2. 2 Select 'MSSql' from the list of DBMS (Database Management Systems).
  3. 3 The driver for your database will be automatically downloaded for you in the folder
    • C:\Users\YourUser\.DbSchema\drivers\MSSql (Windows) or
    • /Users/YourUser/.DbSchema/drivers/MSSql (Linux and MacOS).
    Each database can have multiple connection and authentication methods. Switch to a different method from the dropdown menu.
Choose database and alias
  1. 4

    There are two tabs you can use to connect. 'Compose URL' will ask for the host, port, username, etc., and will create the JDBC URL for you.

    The 'Edit URL' will let you directly enter the JDBC URL.

    You can use the first tab to connect, and then see the created URL in the second tab.

Compose URL Tab Edit URL Tab
  1. 5 If connectivity succeeds, you should get your first DbSchema project and first diagrams.
Database Diagram

Connectivity Troubleshooting

If you get problems connecting to the database, please remember :
  • Press the ping button in the connection dialog to make sure the host and port are reachable.
  • Enable Remote connections as they are not always enabled by default. This may require configuration changes.
  • Windows Firewall may block the communication. You may need to reconfigure or disable it.
  • Check the driver version is compatible with the database software. It may be that DbSchema provided a JDBC driver is not the latest version. Please inform us in this case.
Further connectivity tips can be found on the MSSql Connectivity Tips page.