Merge pull request #33398 from muskan124947/jdbc-12.10.0

JDBC v12.10.0 Content Update

Author: AnnaMHuff

docs/connect/jdbc/connecting-using-azure-active-directory-authentication.md

@@ -3,7 +3,7 @@ title: Connect using Microsoft Entra authentication
 description: Learn how to develop Java applications that use the Microsoft Entra authentication feature with the Microsoft JDBC Driver for SQL Server.
 author: David-Engel
 ms.author: davidengel
-ms.date: 08/29/2024
+ms.date: 03/17/2025
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: conceptual
@@ -82,6 +82,7 @@ The following table lists required library dependencies for each authentication
 | `ActiveDirectoryManagedIdentity`<br/>`ActiveDirectoryMSI`<br/>`ActiveDirectoryDefault` | 12.6.4 | `azure-identity` 1.12.2 |
 | `ActiveDirectoryPassword`<br/>`ActiveDirectoryIntegrated`<br/>`ActiveDirectoryInteractive`<br/>`ActiveDirectoryServicePrincipal`<br/>`ActiveDirectoryServicePrincipalCertificate` | 12.8 | `msal4j` 1.15.1 |
 | `ActiveDirectoryManagedIdentity`<br/>`ActiveDirectoryMSI`<br/>`ActiveDirectoryDefault` | 12.8 | `azure-identity` 1.12.2 |
+| `ActiveDirectoryPassword`<br/>`ActiveDirectoryIntegrated`<br/>`ActiveDirectoryInteractive`<br/>`ActiveDirectoryServicePrincipal`<br/>`ActiveDirectoryServicePrincipalCertificate`<br/>`ActiveDirectoryManagedIdentity`<br/>`ActiveDirectoryMSI`<br/>`ActiveDirectoryDefault` | 12.10 | `azure-identity` 1.15.3 |
 
 ## Connect using ActiveDirectoryManagedIdentity authentication mode
 
@@ -95,7 +96,7 @@ In addition to the library dependency requirements listed in [Client setup requi
   | Driver version | Required dependencies | Azure services supported |
   |----------------|------------------------|--------------|
   | 7.2 - 11.2 | None | [Azure App Service and Azure Functions](/azure/app-service/overview-managed-identity)<br/>[Azure Virtual Machines](/azure/active-directory/managed-identities-azure-resources/how-to-use-vm-token) |
-  | 12.2<br/>12.4<br/>12.6<br/>12.8 | [azure-identity 1.7.0](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-identity/1.7.0/index.html#managed-identity-support)<br/>[azure-identity 1.9.0](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-identity/1.9.0/index.html#managed-identity-support)<br/>[azure-identity 1.11.1](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-identity/1.11.1/index.html#managed-identity-support)<br/>[azure-identity 1.12.2](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-identity/1.12.2/index.html#managed-identity-support) | [Azure App Service and Azure Functions](/azure/app-service/overview-managed-identity)<br/>[Azure Arc](/azure/azure-arc/servers/managed-identity-authentication)<br/>[Azure Cloud Shell](/azure/cloud-shell/msi-authorization)<br/>[Azure Kubernetes Service](/azure/aks/use-managed-identity)<br/>[Azure Service Fabric](/azure/service-fabric/concepts-managed-identity)<br/>[Azure Virtual Machines](/azure/active-directory/managed-identities-azure-resources/how-to-use-vm-token)<br/>[Azure Virtual Machines Scale Sets](/azure/active-directory/managed-identities-azure-resources/qs-configure-powershell-windows-vmss) |
+  | 12.2<br/>12.4<br/>12.6<br/>12.8<br/>12.10 | `azure-identity` 1.7.0<br/>`azure-identity` 1.9.0<br/>`azure-identity` 1.11.1<br/>`azure-identity` 1.12.2<br/>`azure-identity` 1.15.3 | [Azure App Service and Azure Functions](/azure/app-service/overview-managed-identity)<br/>[Azure Arc](/azure/azure-arc/servers/managed-identity-authentication)<br/>[Azure Cloud Shell](/azure/cloud-shell/msi-authorization)<br/>[Azure Kubernetes Service](/azure/aks/use-managed-identity)<br/>[Azure Service Fabric](/azure/service-fabric/concepts-managed-identity)<br/>[Azure Virtual Machines](/azure/active-directory/managed-identities-azure-resources/how-to-use-vm-token)<br/>[Azure Virtual Machines Scale Sets](/azure/active-directory/managed-identities-azure-resources/qs-configure-powershell-windows-vmss) |
 
 The following example shows how to use `authentication=ActiveDirectoryManagedIdentity` mode. Run this example from inside an Azure Resource that is configured for Managed Identity.
 
@@ -182,12 +183,13 @@ The `ActiveDirectoryDefault` authentication option uses the Azure Identity clien
 
 The following table lists the `DefaultAzureCredential` credential chain for each JDBC driver version.
 
-| Driver version | azure-identity version docs | `DefaultAzureCredential` chain |
+| Driver version | azure-identity version | `DefaultAzureCredential` chain |
 |----------------|------------------------|--------------|
-| 12.2 | [azure-identity 1.7.0](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-identity/1.7.0/index.html#defaultazurecredential) | Environment<br/>Managed Identity<br/>IntelliJ<br/>Azure CLI<br/>Azure PowerShell |
-| 12.4 | [azure-identity 1.9.0](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-identity/1.9.0/index.html#defaultazurecredential) | Environment<br/>Workload Identity<br/>Managed Identity<br/>Azure Developer CLI<br/>IntelliJ<br/>Azure CLI<br/>Azure PowerShell |
-| 12.6 | [azure-identity 1.11.1](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-identity/1.11.1/index.html#defaultazurecredential) | Environment<br/>Workload Identity<br/>Managed Identity<br/>Azure Developer CLI<br/>IntelliJ<br/>Azure CLI<br/>Azure PowerShell |
-| 12.8 | [azure-identity 1.12.2](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-identity/1.12.2/index.html#defaultazurecredential) | Environment<br/>Workload Identity<br/>Managed Identity<br/>Azure Developer CLI<br/>IntelliJ<br/>Azure CLI<br/>Azure PowerShell |
+| 12.2 | `azure-identity` 1.7.0 | Environment<br/>Managed Identity<br/>IntelliJ<br/>Azure CLI<br/>Azure PowerShell |
+| 12.4 | `azure-identity` 1.9.0 | Environment<br/>Workload Identity<br/>Managed Identity<br/>Azure Developer CLI<br/>IntelliJ<br/>Azure CLI<br/>Azure PowerShell |
+| 12.6 | `azure-identity` 1.11.1 | Environment<br/>Workload Identity<br/>Managed Identity<br/>Azure Developer CLI<br/>IntelliJ<br/>Azure CLI<br/>Azure PowerShell |
+| 12.8 | `azure-identity` 1.12.2 | Environment<br/>Workload Identity<br/>Managed Identity<br/>Azure Developer CLI<br/>IntelliJ<br/>Azure CLI<br/>Azure PowerShell |
+| 12.10 | `azure-identity` 1.15.3 | Environment<br/>Workload Identity<br/>Managed Identity<br/>Azure Developer CLI<br/>IntelliJ<br/>Azure CLI<br/>Azure PowerShell |
 
 There are many variables that can be set to configure the `Environment` credential. For details on configuring the `DefaultAzureCredential` chain, including the `Environment` credential, see the relevant version of the azure-identity docs linked in the previous table.
 

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

@@ -3,7 +3,7 @@ title: Download
 description: Download the Microsoft JDBC Driver for SQL Server to develop Java applications that connect to SQL Server and Azure SQL Database.
 author: David-Engel
 ms.author: davidengel
-ms.date: 08/22/2024
+ms.date: 03/17/2025
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: conceptual
@@ -14,15 +14,15 @@ The Microsoft JDBC Driver for SQL Server is a Type 4 JDBC driver that provides d
 
 ## Download
 
-Version 12.8 is the latest general availability (GA) version. It supports Java 8, 11, 17, 21, and 22. 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.
+Version 12.10 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.
 
-:::image type="icon" source="../../includes/media/download.svg" border="false"::: **[Download Microsoft JDBC Driver 12.8 for SQL Server (zip)](https://go.microsoft.com/fwlink/?linkid=2283744)**  
-:::image type="icon" source="../../includes/media/download.svg" border="false"::: **[Download Microsoft JDBC Driver 12.8 for SQL Server (tar.gz)](https://go.microsoft.com/fwlink/?linkid=2283563)**
+:::image type="icon" source="../../includes/media/download.svg" border="false"::: **[Download Microsoft JDBC Driver 12.10 for SQL Server (zip)](https://go.microsoft.com/fwlink/?linkid=2310306)**  
+:::image type="icon" source="../../includes/media/download.svg" border="false"::: **[Download Microsoft JDBC Driver 12.10 for SQL Server (tar.gz)](https://go.microsoft.com/fwlink/?linkid=2310307)**
 
 ### Version information
 
-- Release number: 12.8.1
-- Released: August 22, 2024
+- Release number: 12.10.0
+- Released: March 17, 2025
 
 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.
 
@@ -33,11 +33,11 @@ When you download the driver, there are multiple JAR files. The JAR file with `j
 
 This release of Microsoft JDBC Driver for SQL Server is available in the following languages:
 
-Microsoft JDBC Driver 12.8.1 for SQL Server (zip):
-[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2283744&clcid=0x40a)
+Microsoft JDBC Driver 12.10.0 for SQL Server (zip):
+[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2310306&clcid=0x40a)
 
-Microsoft JDBC Driver 12.8.1 for SQL Server (tar.gz):
-[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2283563&clcid=0x40a)
+Microsoft JDBC Driver 12.10.0 for SQL Server (tar.gz):
+[Chinese (Simplified)](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x804) | [Chinese (Traditional)](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x404) | [English (United States)](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x409) | [French](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x40c) | [German](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x407) | [Italian](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x410) | [Japanese](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x411) | [Korean](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x412) | [Portuguese (Brazil)](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x416) | [Russian](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x419) | [Spanish](https://go.microsoft.com/fwlink/?linkid=2310307&clcid=0x40a)
 
 ### Release notes
 
@@ -55,7 +55,7 @@ The JDBC driver can be added to a Maven project by adding it as a dependency in
 <dependency>
     <groupId>com.microsoft.sqlserver</groupId>
     <artifactId>mssql-jdbc</artifactId>
-    <version>12.8.1.jre11</version>
+    <version>12.10.0.jre11</version>
 </dependency>
 ```
 

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

@@ -3,7 +3,7 @@ title: Feature dependencies
 description: Learn about the dependencies that the Microsoft JDBC Driver for SQL Server has and how to meet them.
 author: David-Engel
 ms.author: davidengel
-ms.date: 07/31/2024
+ms.date: 03/17/2025
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: conceptual
@@ -126,6 +126,7 @@ If you're using Maven to build or test your project, Maven automatically downloa
 
 ### Work with the Azure Key Vault provider
 
+- 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))
 - 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))
 - 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))
 - JDBC driver version 12.4.0—Dependency versions: Azure-security-keyvault-keys (version 4.6.1), and Azure-identity (version 1.9.0), and their dependencies ([sample application](azure-key-vault-sample-version-9.2.md))
@@ -152,6 +153,7 @@ If you're using Maven to build or test your project, Maven automatically downloa
 
 ### Work with Microsoft Entra authentication
 
+- JDBC driver version 12.10.0—Dependency versions: Azure-identity (version 1.15.3), and its dependencies.
 - JDBC driver version 12.8.0—Dependency versions: Azure-identity (version 1.12.2), `Msal4j` (version 1.15.1), and their dependencies.
 - JDBC driver version 12.6.0—Dependency versions: Azure-identity (version 1.11.1), `Msal4j` (version 1.14.1), and their dependencies.
 - JDBC driver version 12.4.0—Dependency versions: Azure-identity (version 1.9.0), `Msal4j` (version 1.13.8), and their dependencies.

docs/connect/jdbc/frequently-asked-questions-faq-for-jdbc-driver.yml

@@ -3,7 +3,7 @@ metadata:
   title: Frequently asked questions (FAQ)
   description: This page provides answers to frequently asked questions about the Microsoft JDBC Driver for SQL Server.
   ms.custom: ""
-  ms.date: 07/31/2024
+  ms.date: 03/17/2025
   ms.service: sql
   ms.prod_service: connectivity
   ms.reviewer: ""
@@ -35,6 +35,14 @@ sections:
           The JDBC driver files available on the GitHub repository for the Microsoft JDBC driver are the core of the JDBC driver and are under the open-source license listed in the repository. The driver packages on the [Microsoft download page](download-microsoft-jdbc-driver-for-sql-server.md) include other libraries for Windows-integrated authentication and enabling XA transactions with the JDBC driver. Those other libraries are under the license included with the downloadable package.
           
           **What should I know to upgrade my driver?**  
+          The Microsoft JDBC Driver 12.10 supports the JDBC 4.2, and 4.3 (partially) specifications and includes two JAR class libraries in the installation package as follows:
+          
+          | JAR                        | JDBC Specification            | JDK Version |
+          | -------------------------- | ----------------------------- | ----------- |
+          | mssql-jdbc-12.10.0.jre11.jar | JDBC 4.3 (partially), and 4.2 | JDK 11.0+   |
+          | mssql-jdbc-12.10.0.jre8.jar  | JDBC 4.2                      | JDK 8.0     |
+          |                       |                          |        |
+
           The Microsoft JDBC Driver 12.8 supports the JDBC 4.2, and 4.3 (partially) specifications and includes two JAR class libraries in the installation package as follows:
           
           | JAR                        | JDBC Specification            | JDK Version |

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

@@ -4,7 +4,7 @@ description: This page contains the support matrix and support life-cycle policy
 author: David-Engel
 ms.author: davidengel
 ms.reviewer: randolphwest
-ms.date: 07/31/2024
+ms.date: 03/17/2025
 ms.service: sql
 ms.subservice: connectivity
 ms.topic: conceptual
@@ -25,6 +25,7 @@ The following Microsoft JDBC Drivers are supported, until the indicated End of S
 
 |Driver Name|Driver Package Version|Applicable JARs|End of Mainstream Support|
 |-|-|-|-|
+|Microsoft JDBC Driver 12.10 for SQL Server|12.10|mssql-jdbc-12.10.0.jre11.jar<br> mssql-jdbc-12.10.0.jre8.jar|January 31, 2030|
 |Microsoft JDBC Driver 12.8 for SQL Server|12.8|mssql-jdbc-12.8.0.jre11.jar<br> mssql-jdbc-12.8.0.jre8.jar|July 31, 2029|
 |Microsoft JDBC Driver 12.6 for SQL Server|12.6|mssql-jdbc-12.6.0.jre11.jar<br> mssql-jdbc-12.6.0.jre8.jar|January 31, 2029|
 |Microsoft JDBC Driver 12.4 for SQL Server|12.4|mssql-jdbc-12.4.0.jre11.jar<br> mssql-jdbc-12.4.0.jre8.jar|July 31, 2028|
@@ -60,6 +61,7 @@ The following Microsoft JDBC Drivers are supported, until the indicated End of S
 
 |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|
 |---|---|---|---|---|---|---|---|---|---|---|---|---|
+|12.10|Yes|Yes|Yes|Yes|Yes|Yes|Yes|   |   |   |   |   |
 |12.8|Yes|Yes|Yes|Yes|Yes|Yes|Yes|   |   |   |   |   |
 |12.6|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|   |   |   |   |
 |12.4|Yes|Yes|Yes|Yes|Yes|Yes|Yes|Yes|   |   |   |   |
@@ -98,6 +100,7 @@ The following Microsoft JDBC Drivers are supported, until the indicated End of S
 
 |JDBC Driver Version|JRE Versions|JDBC API Version|
 |-|-|-|
+|[12.10](release-notes-for-the-jdbc-driver.md#130)|1.8, 11, 17, 21, 23|4.2, 4.3 (partially)|
 |[12.8](release-notes-for-the-jdbc-driver.md#128)|1.8, 11, 17, 21, 22|4.2, 4.3 (partially)|
 |[12.6](release-notes-for-the-jdbc-driver.md#126)|1.8, 11, 17, 21|4.2, 4.3 (partially)|
 |[12.4](release-notes-for-the-jdbc-driver.md#124)|1.8, 11, 17, 20|4.2, 4.3 (partially)|