Skip to content

Commit 147176e

Browse files
David-Engelmuskan124947JillGrant615
authored
JDBC 13.4 GA release update (#36860)
* Doc update for 13.4 release * Updates * Updates * Updated fw links * Updated Release notes * Addressed comments * Addressed comments * Tweaks to the docs for the 13.4 release plus acrolinx fixes * Fix capitalization * Fix links * Update metadata in JDBC release notes --------- Co-authored-by: Muskan Gupta <muskgupta@microsoft.com> Co-authored-by: Jill Grant <72043882+JillGrant615@users.noreply.github.com>
1 parent b192cd7 commit 147176e

12 files changed

Lines changed: 401 additions & 77 deletions

docs/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Download
33
description: Download the Microsoft JDBC Driver for SQL Server to develop Java applications that connect to SQL Server and Azure SQL Database.
44
author: David-Engel
55
ms.author: davidengel
6-
ms.date: 10/13/2025
6+
ms.date: 03/13/2026
77
ms.service: sql
88
ms.subservice: connectivity
99
ms.topic: concept-article
@@ -14,15 +14,15 @@ The Microsoft JDBC Driver for SQL Server is a Type 4 JDBC driver that provides d
1414

1515
## Download
1616

17-
Version 13.2 is the latest general availability (GA) version. It supports Java 8, 11, 17, 21 and 23. If you need to use an older Java runtime, see the [Java and JDBC specification support matrix](microsoft-jdbc-driver-for-sql-server-support-matrix.md#java-and-jdbc-specification-support) to see if there's a supported driver version you can use. We're continually improving Java connectivity support. As such we highly recommend that you work with the latest version of Microsoft JDBC driver.
17+
Version 13.4 is the latest general availability (GA) version. It supports Java 8, 11, 17, 21 and 25. If you need to use an older Java runtime, see the [Java and JDBC specification support matrix](microsoft-jdbc-driver-for-sql-server-support-matrix.md#java-and-jdbc-specification-support) to see if there's a supported driver version you can use. We're continually improving Java connectivity support. As such we highly recommend that you work with the latest version of Microsoft JDBC driver.
1818

19-
:::image type="icon" source="../../includes/media/download.svg" border="false"::: **[Download Microsoft JDBC Driver 13.2.1 for SQL Server (zip)](https://go.microsoft.com/fwlink/?linkid=2338346)**
20-
:::image type="icon" source="../../includes/media/download.svg" border="false"::: **[Download Microsoft JDBC Driver 13.2.1 for SQL Server (tar.gz)](https://go.microsoft.com/fwlink/?linkid=2338543)**
19+
:::image type="icon" source="../../includes/media/download.svg" border="false"::: **[Download Microsoft JDBC Driver 13.4.0 for SQL Server (zip)](https://go.microsoft.com/fwlink/?linkid=2356503)**
20+
:::image type="icon" source="../../includes/media/download.svg" border="false"::: **[Download Microsoft JDBC Driver 13.4.0 for SQL Server (tar.gz)](https://go.microsoft.com/fwlink/?linkid=2356504)**
2121

2222
### Version information
2323

24-
- Release number: 13.2.1
25-
- Released: October 13, 2025
24+
- Release number: 13.4.0
25+
- Released: March 13, 2026
2626

2727
When you download the driver, there are multiple JAR files. The JAR file with `jre8` supports Java 8 and the JAR file with `jre11` supports Java 11 and up.
2828

@@ -33,11 +33,11 @@ When you download the driver, there are multiple JAR files. The JAR file with `j
3333

3434
This release of Microsoft JDBC Driver for SQL Server is available in the following languages:
3535

36-
Microsoft JDBC Driver 13.2.1 for SQL Server (zip):
37-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2338346&clcid=0x40a)
36+
Microsoft JDBC Driver 13.4.0 for SQL Server (zip):
37+
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2356503&clcid=0x40a)
3838

39-
Microsoft JDBC Driver 13.2.1 for SQL Server (tar.gz):
40-
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2338543&clcid=0x40a)
39+
Microsoft JDBC Driver 13.4.0 for SQL Server (tar.gz):
40+
[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2356504&clcid=0x40a)
4141

4242
### Release notes
4343

@@ -55,7 +55,7 @@ The JDBC driver can be added to a Maven project by adding it as a dependency in
5555
<dependency>
5656
<groupId>com.microsoft.sqlserver</groupId>
5757
<artifactId>mssql-jdbc</artifactId>
58-
<version>13.2.1.jre11</version>
58+
<version>13.4.0.jre11</version>
5959
</dependency>
6060
```
6161

docs/connect/jdbc/feature-dependencies-of-microsoft-jdbc-driver-for-sql-server.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Feature dependencies
33
description: Learn about the dependencies that the Microsoft JDBC Driver for SQL Server has and how to meet them.
44
author: David-Engel
55
ms.author: davidengel
6-
ms.date: 03/17/2025
6+
ms.date: 03/13/2026
77
ms.service: sql
88
ms.subservice: connectivity
99
ms.topic: concept-article
@@ -126,6 +126,8 @@ If you're using Maven to build or test your project, Maven automatically downloa
126126

127127
### Work with the Azure Key Vault provider
128128

129+
- JDBC driver version 13.4.0—Dependency versions: Azure-security-keyvault-keys (version 4.10.5), and Azure-identity (version 1.18.2), and their dependencies ([sample application](azure-key-vault-sample-version-9.2.md))
130+
- JDBC driver version 13.2.0—Dependency versions: Azure-security-keyvault-keys (version 4.9.2), and Azure-identity (version 1.15.3), and their dependencies ([sample application](azure-key-vault-sample-version-9.2.md))
129131
- JDBC driver version 12.10.0—Dependency versions: Azure-security-keyvault-keys (version 4.9.2), and Azure-identity (version 1.15.3), and their dependencies ([sample application](azure-key-vault-sample-version-9.2.md))
130132
- JDBC driver version 12.8.0—Dependency versions: Azure-security-keyvault-keys (version 4.7.3), and Azure-identity (version 1.12.2), and their dependencies ([sample application](azure-key-vault-sample-version-9.2.md))
131133
- JDBC driver version 12.6.0—Dependency versions: Azure-security-keyvault-keys (version 4.7.3), and Azure-identity (version 1.11.1), and their dependencies ([sample application](azure-key-vault-sample-version-9.2.md))
@@ -153,6 +155,8 @@ If you're using Maven to build or test your project, Maven automatically downloa
153155

154156
### Work with Microsoft Entra authentication
155157

158+
- JDBC driver version 13.4.0—Dependency versions: Azure-identity (version 1.18.2), and its dependencies.
159+
- JDBC driver version 13.2.0—Dependency versions: Azure-identity (version 1.15.3), and its dependencies.
156160
- JDBC driver version 12.10.0—Dependency versions: Azure-identity (version 1.15.3), and its dependencies.
157161
- JDBC driver version 12.8.0—Dependency versions: Azure-identity (version 1.12.2), `Msal4j` (version 1.15.1), and their dependencies.
158162
- JDBC driver version 12.6.0—Dependency versions: Azure-identity (version 1.11.1), `Msal4j` (version 1.14.1), and their dependencies.
@@ -179,6 +183,16 @@ From driver version 8.2.2 onward, `sqljdbc_auth.dll` is renamed to `mssql-jdbc_a
179183

180184
In addition to the **mssql-jdbc_auth-\<version>-\<arch>.dll** (available in the JDBC driver package), the Azure Active Directory Authentication Library (**ADAL.DLL**) also must be installed for Active Directory Integrated authentication. Microsoft Azure Active Directory Authentication Library can be installed from [Microsoft ODBC Driver for SQL Server](../odbc/download-odbc-driver-for-sql-server.md) or [Microsoft OLE DB Driver for SQL Server](../oledb/download-oledb-driver-for-sql-server.md). The JDBC driver only supports version **1.0.2028.318 and higher** for ADAL.DLL.
181185

186+
(Version 13.4+) The legacy ADAL dependency (`adalsql.dll`/`adal.dll`) has been fully removed. **Authentication=ActiveDirectoryIntegrated** now uses `mssql-auth.dll`, a component installed by the latest Microsoft ODBC Driver 18 for SQL Server and Microsoft OLE DB Driver 19 for SQL Server.
187+
188+
If you receive the following error, install the library from [Microsoft ODBC Driver for SQL Server](../odbc/download-odbc-driver-for-sql-server.md) or [Microsoft OLE DB Driver for SQL Server](../oledb/download-oledb-driver-for-sql-server.md):
189+
190+
```output
191+
Unable to load mssql-auth.dll. Error code: 0x7e.
192+
For more information, see:
193+
https://go.microsoft.com/fwlink/?LinkID=513072
194+
```
195+
182196
You can get a [sample application](connecting-using-azure-active-directory-authentication.md) that uses this feature.
183197

184198
## See also

docs/connect/jdbc/improving-performance-and-reliability-with-the-jdbc-driver.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: Improving performance and reliability
33
description: Learn about various techniques for improving application performance and reliability when using the Microsoft JDBC driver for SQL Server.
44
author: David-Engel
55
ms.author: davidengel
6-
ms.date: 12/18/2025
6+
ms.date: 03/13/2026
77
ms.service: sql
88
ms.subservice: connectivity
99
ms.topic: concept-article
@@ -31,6 +31,7 @@ The articles in this section describe various techniques for improving applicati
3131
|[Prepared statement parameter performance](prepared-statement-parameter-performance.md)|Discusses practices and settings to consider when using prepared statements.|
3232
|[Using bulk copy API for batch insert operation](use-bulk-copy-api-batch-insert-operation.md)|Describes how to enable Bulk Copy API for batch insert operations and its benefits.|
3333
|[Not sending String parameters as Unicode](setting-the-connection-properties.md)|When you're working with **CHAR**, **VARCHAR**, and **LONGVARCHAR** data, set the connection property **sendStringParametersAsUnicode** to `false` for optimal performance gain.|
34+
|[Performance Logger and callback](performance-logger-callback.md)|Describes how to use the performance logging framework and callback infrastructure to track execution timing for critical driver operations such as connections, prelogin, login, and token acquisition.|
3435

3536
## See also
3637

docs/connect/jdbc/microsoft-jdbc-driver-for-sql-server-support-matrix.md

Lines changed: 17 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This page contains the support matrix and support life-cycle policy
44
author: David-Engel
55
ms.author: davidengel
66
ms.reviewer: randolphwest
7-
ms.date: 11/05/2025
7+
ms.date: 03/13/2026
88
ms.service: sql
99
ms.subservice: connectivity
1010
ms.topic: feature-availability
@@ -33,12 +33,12 @@ The following Microsoft JDBC Drivers are supported, until the indicated End of S
3333
|Microsoft JDBC Driver 11.2 for SQL Server|11.2|mssql-jdbc-11.2.0.jre18.jar<br> mssql-jdbc-11.2.0.jre17.jar<br> mssql-jdbc-11.2.0.jre11.jar<br> mssql-jdbc-11.2.0.jre8.jar|August 4, 2027|
3434
|Microsoft JDBC Driver 10.2 for SQL Server|10.2|mssql-jdbc-10.2.0.jre17.jar<br> mssql-jdbc-10.2.0.jre11.jar<br> mssql-jdbc-10.2.0.jre8.jar|January 31, 2027|
3535
|Microsoft JDBC Driver 9.4 for SQL Server|9.4|mssql-jdbc-9.4.1.jre16.jar<br> mssql-jdbc-9.4.1.jre11.jar<br> mssql-jdbc-9.4.1.jre8.jar|July 30, 2026|
36-
|Microsoft JDBC Driver 9.2 for SQL Server|9.2|mssql-jdbc-9.2.1.jre15.jar<br> mssql-jdbc-9.2.1.jre11.jar<br> mssql-jdbc-9.2.1.jre8.jar|January 29, 2026|
3736

3837
The following Microsoft JDBC Drivers are no longer supported.
3938

4039
|Driver Name|Driver Package Version|End of Mainstream Support|
4140
|-|-|-|
41+
|Microsoft JDBC Driver 9.2 for SQL Server|9.2|January 29, 2026|
4242
|Microsoft JDBC Driver 8.4 for SQL Server|8.4|July 31, 2025|
4343
|Microsoft JDBC Driver 8.2 for SQL Server|8.2|January 31, 2025|
4444
|Microsoft JDBC Driver 7.4 for SQL Server|7.4|July 31, 2024|
@@ -63,53 +63,26 @@ Microsoft JDBC Driver for SQL Server defines external dependencies in its Maven
6363

6464
## SQL version compatibility
6565

66-
|Database version&nbsp;&#8594;<br />&#8595; Driver Version|Azure SQL Database|Azure Synapse Analytics|Azure SQL Managed Instance|SQL Server 2022|SQL Server 2019|SQL Server 2017|SQL Server 2016|SQL Server 2014|SQL Server 2012|
67-
|---|---|---|---|---|---|---|---|---|---|
68-
|13.2|Yes|Yes|Yes|Yes|Yes|Yes|Yes| | |
69-
|12.10|Yes|Yes|Yes|Yes|Yes|Yes|Yes| | |
70-
|12.8|Yes|Yes|Yes|Yes|Yes|Yes|Yes| | |
71-
|12.6|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes| |
72-
|12.4|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes| |
73-
|12.2|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes| |
74-
|11.2|Yes|Yes|Yes| |Yes|Yes|Yes|Yes| |
75-
|10.2|Yes|Yes|Yes| |Yes|Yes|Yes|Yes|Yes|
76-
| 9.4|Yes|Yes|Yes| |Yes|Yes|Yes|Yes|Yes|
77-
| 9.2|Yes|Yes|Yes| |Yes|Yes|Yes|Yes|Yes|
78-
79-
|Database version&nbsp;&#8594;<br />&#8595; Driver Version|Azure SQL Database|Azure Synapse Analytics|Azure SQL Managed Instance|SQL Server 2022|SQL Server 2019|SQL Server 2017|SQL Server 2016|SQL Server 2014|SQL Server 2012|PDW 2008R2 AU3<sup>4</sup>|SQL Server 2008 R2|SQL Server 2008|
80-
|---|---|---|---|---|---|---|---|---|---|---|---|---|
81-
| 8.4|Yes|Yes|Yes| |Yes|Yes|Yes|Yes|Yes|Yes| | |
82-
| 8.2|Yes|Yes|Yes| |Yes|Yes|Yes|Yes|Yes|Yes| | |
83-
| 7.4|Yes|Yes|Yes| |Yes|Yes|Yes|Yes|Yes|Yes| | |
84-
| 7.2|Yes|Yes|Yes| | |Yes|Yes|Yes|Yes|Yes|Yes| |
85-
| 7.0|Yes|Yes|Yes| | |Yes|Yes|Yes|Yes|Yes|Yes| |
86-
| 6.4|Yes|Yes|Yes| | |Yes|Yes|Yes|Yes|Yes|Yes| |
87-
| 6.2|Yes|Yes| | | |Yes|Yes|Yes|Yes|Yes|Yes|Yes|
88-
| 6.1|Yes| | | | | |Yes|Yes|Yes|Yes|Yes|Yes|
89-
| 6.0|Yes| | | | | |Yes|Yes|Yes|Yes|Yes|Yes|
90-
| 4.2|Yes| | | | | |Yes|Yes|Yes|Yes|Yes|Yes|
91-
| 4.1|Yes| | | | | |Yes|Yes|Yes|Yes|Yes|Yes|
92-
| 4.0|Yes| | | | | |Yes|Yes|Yes|Yes|Yes|Yes|
93-
| 3.0|Yes<sup>2</sup> || | | | | |Yes<sup>5</sup>|Yes<sup>1</sup>| |Yes|Yes|
94-
| 2.0| | | | | | | | | | |Yes<sup>3</sup>|Yes<sup>3</sup>|
95-
| 1.2| | | | | | | | | | | |Yes<sup>3</sup>|
96-
97-
<sup>1</sup> Microsoft SQL Server JDBC Driver version 3.0 can connect to SQL Server 2012 as a down-level client.
98-
99-
<sup>2</sup> Support for Azure SQL Database was introduced in the 3.0 driver as a hotfix. We recommend that Azure SQL Database customers use the latest driver version available.
100-
101-
<sup>3</sup> Microsoft SQL Server JDBC Driver version 2.0 and Microsoft SQL Server 2005 JDBC Driver version 1.2 can connect to SQL Server 2008 as a down-level client. When down-level conversions are allowed, applications can execute queries and perform updates on the new SQL Server 2008 data types, such as time, date, datetime2, datetimeoffset, and FILESTREAM. For more information about how to use these new data types with the JDBC driver, see [Working with SQL Server 2008 Date/Time Data Types using JDBC Driver](/archive/blogs/jdbcteam/) and [Working with SQL Server 2008 FileStream using JDBC Driver](/archive/blogs/jdbcteam/). For more information about the down-level compatibility of these new data types, see [Using Date and Time Data](/previous-versions/sql/sql-server-2008-r2/ms180878(v=sql.105)) and [FILESTREAM Support](../../relational-databases/native-client/features/filestream-support.md) articles in SQL Server Books Online.
102-
103-
<sup>4</sup> Support for connections between the Microsoft JDBC Driver and Parallel Data Warehouse was first introduced in the Microsoft JDBC Driver 4.0 for SQL Server and Microsoft SQL Server 2008 R2 Parallel Data Warehouse Appliance Update 3.
104-
105-
<sup>5</sup> Microsoft SQL Server JDBC Driver version 3.0 can connect to SQL Server 2014 as a down-level client.
66+
All currently supported JDBC driver versions (9.4 and later) support all supported versions of Microsoft SQL, including:
67+
68+
- Microsoft SQL Server
69+
- Azure SQL Database
70+
- Azure Synapse Analytics
71+
- Azure SQL Managed Instance
72+
- SQL database in Microsoft Fabric
73+
- Microsoft Fabric Data Warehouse
74+
75+
Feature support is separate from compatibility with server versions. For details on feature support, see the [Driver Feature Support Matrix](../driver-feature-matrix.md#table2) or the release notes for each driver version.
76+
77+
For the best experience, use the latest JDBC driver.
10678

10779
## Java and JDBC specification support
10880

10981
|JDBC Driver Version|JRE Versions|JDBC API Version|
11082
|-|-|-|
111-
|[13.2](release-notes-for-the-jdbc-driver.md#131)|1.8, 11, 17, 21, 24|4.2, 4.3 (partially)|
112-
|[12.10](release-notes-for-the-jdbc-driver.md#130)|1.8, 11, 17, 21, 23|4.2, 4.3 (partially)|
83+
|[13.4](release-notes-for-the-jdbc-driver.md#134)|1.8, 11, 17, 21, 25|4.2, 4.3 (partially)|
84+
|[13.2](release-notes-for-the-jdbc-driver.md#132)|1.8, 11, 17, 21, 24|4.2, 4.3 (partially)|
85+
|[12.10](release-notes-for-the-jdbc-driver.md#1210)|1.8, 11, 17, 21, 23|4.2, 4.3 (partially)|
11386
|[12.8](release-notes-for-the-jdbc-driver.md#128)|1.8, 11, 17, 21, 22|4.2, 4.3 (partially)|
11487
|[12.6](release-notes-for-the-jdbc-driver.md#126)|1.8, 11, 17, 21|4.2, 4.3 (partially)|
11588
|[12.4](release-notes-for-the-jdbc-driver.md#124)|1.8, 11, 17, 20|4.2, 4.3 (partially)|

0 commit comments

Comments
 (0)