Microsoft JDBC Driver for SQL Server

Welcome to the Microsoft JDBC Driver for SQL Server project!

The Microsoft JDBC Driver for SQL Server is a Type 4 JDBC driver that provides database connectivity through the standard JDBC application program interfaces (APIs) available in the Java Platform, Enterprise Editions. The Driver provides access to Microsoft SQL Server and Azure SQL Database from any Java application, application server, or Java-enabled applet.

We hope you enjoy using the Microsoft JDBC Driver for SQL Server.

SQL Server Team

Status of Most Recent Builds

AppVeyor (Windows)	Travis CI (Linux)

Announcements

What's coming next? We will look into adding a more comprehensive set of tests, improving our javadocs, and start developing the next set of features.

Get Started

• Ubuntu + SQL Server + Java
• Red Hat + SQL Server + Java
• Mac + SQL Server + Java
• Windows + SQL Server + Java

Build

Prerequisites

• Java 8
• Ant (with Ivy), Maven or Gradle
• An instance of SQL Server or Azure SQL Database that you can connect to.

Build the JAR files

The build automatically triggers a set of verification tests to run. For these tests to pass, you will first need to add an environment variable in your system called mssql_jdbc_test_connection_properties to provide the correct connection properties for your SQL Server or Azure SQL Database instance.

To build the jar files, you must use Java 8 with either Ant (with Ivy), Maven or Gradle. You can choose to build a JDBC 4.1 compliant jar file (for use with JRE 7) and/or a JDBC 4.2 compliant jar file (for use with JRE 8).

• Ant:

  1. If you have not already done so, add the environment variable mssql_jdbc_test_connection_properties in your system with the connection properties for your SQL Server or SQL DB instance.
  2. Run one of the commands below to build a JDBC 4.1 compliant jar, JDBC 4.2 compliant jar, or both in the \build directory.
     • Run ant. This creates both JDBC 4.1 compliant jar and JDBC 4.2 compliant jar in \build directory
     • Run ant build41. This creates JDBC 4.1 compliant jar in \build directory
     • Run ant build42. This creates JDBC 4.2 compliant jar in \build directory

• Maven:

  1. If you have not already done so, add the environment variable mssql_jdbc_test_connection_properties in your system with the connection properties for your SQL Server or SQL DB instance.
  2. Run one of the commands below to build a JDBC 4.1 compliant jar or JDBC 4.2 compliant jar in the \target directory.
     • Run mvn install -Pbuild41. This creates JDBC 4.1 compliant jar in \target directory
     • Run mvn install -Pbuild42. This creates JDBC 4.2 compliant jar in \target directory

• Gradle:

  1. If you have not already done so, add the environment variable mssql_jdbc_test_connection_properties in your system with the connection properties for your SQL Server or SQL DB instance.
  2. Run one of the commands below to build a JDBC 4.1 compliant jar or JDBC 4.2 compliant jar in the \build\libs directory.
     • Run gradle build -Pbuild=build41. This creates JDBC 4.1 compliant jar in \build\libs directory
     • Run gradle build -Pbuild=build42. This creates JDBC 4.2 compliant jar in \build\libs directory

Resources

Documentation

This driver is documented on Microsoft's Documentation web site.

Sample Code

For samples, please see the src\sample directory.

Download the DLLs

For some features (e.g. Integrated Authentication and Distributed Transactions), you may need to use the sqljdbc_xa and sqljdbc_auth DLLs. They can be downloaded from the Microsoft Download Center

Download the driver

Don't want to compile anything?

We're now on the Maven Central Repository. Add the following to your POM file:

<dependency>
	<groupId>com.microsoft.sqlserver</groupId>
	<artifactId>mssql-jdbc</artifactId>
	<version>6.1.0.jre8</version>
</dependency>

The driver can be downloaded from the Microsoft Download Center

##Dependencies This project has following dependencies:

Compile Time:

• azure-keyvault : Azure Key Vault Provider for Always Encrypted feature

Test Time:

• junit:jar : For Unit Test cases.

###Dependency Tree One can see all dependencies including Transitive Dependency by executing following command.

mvn dependency:tree

###Exclude Dependencies If you wish to limit the number of run-time dependencies, and your project does not require the features named above, you can explicitly exclude them by adding exclusion tag.
For Example: If you are not using Always Encrypted Azure Key Vault feature then you can exclude azure-keyvault dependency. Please see following snippet.

<dependency>
	<groupId>com.microsoft.sqlserver</groupId>
	<artifactId>mssql-jdbc</artifactId>
	<version>6.1.0.jre8</version>
	<scope>compile</scope>
	<exclusions>
		<exclusion>
		         <groupId>com.microsoft.azure</groupId>
		         <artifactId>azure-keyvault</artifactId>
		</exclusion>
    </exclusions>
</dependency>

Guidelines for Reporting Issues

We appreciate you taking the time to test the driver, provide feedback and report any issues. It would be extremely helpful if you:

• Report each issue as a new issue (but check first if it's already been reported)
• Try to be detailed in your report. Useful information for good bug reports include:
  • What you are seeing and what the expected behaviour is
  • Which jar file?
  • Environment details: e.g. Java version, client operating system?
  • Table schema (for some issues the data types make a big difference!)
  • Any other relevant information you want to share
• Try to include a Java sample demonstrating the isolated problem.

Thank you!

Reporting security issues and security bugs

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

License

The Microsoft JDBC Driver for SQL Server is licensed under the MIT license. See the LICENSE file for more details.

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.