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
Let us know how you think we're doing.
AppVeyor (Windows) | Travis CI (Linux) |
---|---|
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.
- Ubuntu + SQL Server + Java
- Red Hat + SQL Server + Java
- Mac + SQL Server + Java
- Windows + SQL Server + Java
- Java 9
- Maven
- An instance of SQL Server or Azure SQL Database that you can connect to.
Maven builds automatically trigger 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 9 with Maven. You can choose to build a JDBC 4.3 compliant jar file (for use with JRE 9) and/or a JDBC 4.2 compliant jar file (for use with JRE 8).
- Maven:
- 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. - Run one of the commands below to build a JDBC 4.3 compliant jar or JDBC 4.2 compliant jar in the \target directory.
- Run
mvn install -Pbuild43
. This creates JDBC 4.3 compliant jar in \target directory - Run
mvn install -Pbuild42
. This creates JDBC 4.2 compliant jar in \target directory
- Run
- If you have not already done so, add the environment variable
NOTE: Beginning release v6.1.7, we will no longer be maintaining the existing Gradle build script and it will be left in the repository for reference. Please refer to issue #62 for this decision.
- Gradle:
- 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. - 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
- Run
- If you have not already done so, add the environment variable
API reference documentation is available in Javadocs.
This driver is documented on Microsoft's Documentation web site.
For samples, please see the src\sample directory.
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
Don't want to compile anything?
We're now on the Maven Central Repository. Add the following to your POM file to get the most stable release:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>6.4.0.jre9</version>
</dependency>
The driver can be downloaded from the Microsoft Download Center.
To get the latest preview version of the driver, add the following to your POM file:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>6.5.1.jre9-preview</version>
</dependency>
This project has following dependencies:
Compile Time:
azure-keyvault
: Azure Key Vault Provider for Always Encrypted Azure Key Vault feature (optional)adal4j
: Azure ActiveDirectory Library for Java for Azure Active Directory Authentication feature and Azure Key Vault feature (optional)
Test Time:
junit:jar
: For Unit Test cases.
One can see all dependencies including Transitive Dependency by executing following command.
mvn dependency:tree
Projects that require either of the two features need to explicitly declare the dependency in their pom file.
For Example: If you are using Azure Active Directory Authentication feature then you need to redeclare adal4j dependency in your project's pom file. Please see the following snippet:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>6.5.1.jre9-preview</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>com.microsoft.azure</groupId>
<artifactId>adal4j</artifactId>
<version>1.4.0</version>
</dependency>
For Example: If you are using Azure Key Vault feature then you need to redeclare azure-keyvault dependency and adal4j dependency in your project's pom file. Please see the following snippet:
<dependency>
<groupId>com.microsoft.sqlserver</groupId>
<artifactId>mssql-jdbc</artifactId>
<version>6.5.1.jre9-preview</version>
<scope>compile</scope>
</dependency>
<dependency>
<groupId>com.microsoft.azure</groupId>
<artifactId>adal4j</artifactId>
<version>1.4.0</version>
</dependency>
<dependency>
<groupId>com.microsoft.azure</groupId>
<artifactId>azure-keyvault</artifactId>
<version>1.0.0</version>
</dependency>
Please note as of the v6.2.2, the way to construct a SQLServerColumnEncryptionAzureKeyVaultProvider
object has changed. Please refer to this Wiki page for more information.
We love contributions from the community. To help improve the quality of our code, we encourage you to use the mssql-jdbc_formatter.xml formatter provided on all pull requests.
Thank you!
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!
Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) [email protected]. 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.
Our goal is to release regular updates which improve the driver and bring new features to users. Stable, production quality releases happen twice a year, targeting the first and third quarters of the calendar year. They are tested against a comprehensive matrix of supported operating systems, Java versions, and SQL Server versions. Stable releases are accompanied by additional localized packages, which are available on the Microsoft website.
Preview releases happen approximately monthly between stable releases. This gives users an opportunity to try out new features and provide feedback on them before they go into stable releases. Preview releases also include frequent bug fixes for customers to verify without having to wait for a stable release. Preview releases are only available in English. While they are tested, preview releases do not necessarily go through the same rigorous, full test matrix and review process as stable releases.
You can see what is going into a future release by monitoring Milestones in the repository.
Starting with 6.0, stable versions have an even minor version. For example, 6.0, 6.2, 6.4. Preview versions have an odd minor version. For example, 6.1, 6.3, 6.5.
Special thanks to everyone who has contributed to the project.
Up-to-date list of contributors: https://github.com/Microsoft/mssql-jdbc/graphs/contributors
- marschall (Philippe Marschall)
- pierresouchay (Pierre Souchay)
- gordthompson (Gord Thompson)
- gstojsic
- cosmofrit
- JamieMagee (Jamie Magee)
- mfriesen (Mike Friesen)
- tonytamwk
- sehrope (Sehrope Sarkuni)
- jacobovazquez
- brettwooldridge (Brett Wooldridge)
The Microsoft JDBC Driver for SQL Server is licensed under the MIT license. See the LICENSE file for more details.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.