Updates for 13.1.0 preview release (#2698)

* Updates for 13.1.0 preview release

* committing README change

* Apply suggestions from code review

* Added changes to remaining files

---------

Co-authored-by: David Engel <[email protected]>

Author: machavan

CHANGELOG.md

@@ -3,6 +3,128 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 
+## [13.1.0] Preview Release
+
+### Added
+
+- **Vector datatype support** [#2634](https://github.com/microsoft/mssql-jdbc/pull/2634)  
+  **What was added**: Native support for SQL Server’s new `VECTOR` data type with APIs for inserts, selects, stored procedures, and bulk copy.  
+  **Who benefits**: Developers building AI/ML workloads or semantic search applications using vector data in SQL Server.  
+  **Impact**: Enables native vector storage and access via JDBC, eliminating the performance overhead of managing vector data as strings.  
+
+
+- **New connection options, `quotedIdentifier` and `concatNullYieldsNull`** [#2618](https://github.com/microsoft/mssql-jdbc/pull/2618)  
+  **What was added**: ) New connection options, `quotedIdentifier` and `concatNullYieldsNull`, to control QUOTED_IDENTIFIER and CONCAT_NULL_YIELDS_NULL session settings for both new and pooled connections.  
+  **Who benefits**: Developers needing Sybase-default behavior for their applications.  
+  **Impact**: Reduces Sybase migration effort by allowing control of these session values.  
+
+
+- **Support for temporal and money datatypes when using bulk copy for batch insert operations** [#2670](https://github.com/microsoft/mssql-jdbc/pull/2670)  
+  **What was added**: Support for batch inserts of `DATETIME`, `DATE`, `MONEY`, etc., when using the `useBulkCopyForBatchInsert` option.  
+  **Who benefits**: High-volume data insert users.  
+  **Impact**: Improves performance for previously unsupported types (except in Azure Synapse Analytics (formerly Azure SQL DW).  
+
+
+- **Mockito integration into JDBC driver tests** [#2644](https://github.com/microsoft/mssql-jdbc/pull/2644)  
+  **What was added**: Mockito added as a test dependency.  
+  **Who benefits**: Developers and contributors writing unit tests.  
+  **Impact**: Enables better control and test coverage.  
+
+
+### Changed
+
+- **`releaseSavepoint` exception type standardized to `SQLFeatureNotSupported`** [#2583](https://github.com/microsoft/mssql-jdbc/pull/2583)  
+  **What changed**: SQLServerException replaced with SQLFeatureNotSupportedException to comply with JDBC specification.  
+  **Who benefits**: Developers expecting JDBC standard exceptions.  
+  **Impact**: Enables better exception handling in client code.  
+
+
+- **`ActiveDirectoryPassword` authentication deprecated** [#2624](https://github.com/microsoft/mssql-jdbc/pull/2624)  
+  **What changed**: Added deprecation warning for Microsoft Entra ID password authentication method.  
+  **Who benefits**: Microsoft Entra ID authentication users.  
+  **Impact**: Encourages migration to more secure methods.  
+
+
+- **Include Columnstore indexes in `getIndexInfo()`** [#2598](https://github.com/microsoft/mssql-jdbc/pull/2598)  
+  **What changed**: Replaced `sp_statistics` with a custom query to support all index types.  
+  **Who benefits**: Developers using metadata APIs.  
+  **Impact**: More accurate index metadata.  
+
+
+- **Corrected schema filtering in `getSchemas()`** [#2643](https://github.com/microsoft/mssql-jdbc/pull/2643)  
+  **What changed**: Ensured schemas are properly filtered when a catalog name is provided.  
+  **Who benefits**: Users of metadata functions.  
+  **Impact**: Complies with JDBC specification and avoids confusion.  
+
+
+- **Increased redirection limit** [#2659](https://github.com/microsoft/mssql-jdbc/pull/2659)  
+  **What changed**: Raised maximum redirection hops from 1 to 10.  
+  **Who benefits**: Azure SQL Fabric users.  
+  **Impact**: Enables successful multi-hop connection scenarios.  
+
+
+### Fixed issues
+
+- **Session recovery with Entra ID authentication and redirect mode** [#2668](https://github.com/microsoft/mssql-jdbc/pull/2668)  
+  **What was fixed**: Redirect information is now followed during session recovery when using Entra ID authentication.  
+  **Who benefits**: Azure SQL DB users using Entra ID and connection resiliency.  
+  **Impact**: Prevents connection recovery failures.  
+
+
+- **Javadoc build warnings** [#2640](https://github.com/microsoft/mssql-jdbc/pull/2640)  
+  **What was fixed**: Cleaned up invalid Javadoc syntax.  
+  **Who benefits**: Developers building the driver.  
+  **Impact**: Cleaner builds, better docs.  
+
+
+- **OffsetDateTime formatting in SQLServerDataTable** [#2652](https://github.com/microsoft/mssql-jdbc/pull/2652)  
+  **What was fixed**: The `OffsetDateTime` `toString()` method was omitting seconds when seconds are zero, which resulted in the server rejecting those records. Used `DateTimeFormatter` to avoid this invalid format.  
+  **Who benefits**: Users inserting `OffsetDateTime` values.  
+  **Impact**: Prevents conversion errors.  
+
+
+- **String comparison in SQLServerDataTable.equals()** [#2653](https://github.com/microsoft/mssql-jdbc/pull/2653)  
+  **What was fixed**: Replaced `==` with `.equals()` for strings.  
+  **Who benefits**: Anyone comparing data tables.  
+  **Impact**: Accurate comparison behavior.  
+
+
+- **PreparedStatement metadata caching for encrypted columns** [#2663](https://github.com/microsoft/mssql-jdbc/pull/2663)  
+  **What was fixed**: Fixed loss of type metadata across `PreparedStatement` reuse.  
+  **Who benefits**: Users of Always Encrypted with secure enclaves.  
+  **Impact**: Prevents insert failures in batch encryption.  
+
+
+- **Make IBM security module optional** [#2636](https://github.com/microsoft/mssql-jdbc/pull/2636)  
+  **What was fixed**: IBM security dependency is now optional.  
+  **Who benefits**: Applications not using IBM modules.  
+  **Impact**: Avoids classloading issues.  
+
+
+- **Invalidate enclave session on reconnect** [#2638](https://github.com/microsoft/mssql-jdbc/pull/2638)  
+  **What was fixed**: Enclave session cache no longer reused across reconnects.  
+  **Who benefits**: Users of Always Encrypted with secure enclaves in failover configurations.  
+  **Impact**: Prevents internal enclave errors due to invalid enclave session references after failover.  
+
+
+- **File path error handling in `ConfigurableRetryLogic`** [#2650](https://github.com/microsoft/mssql-jdbc/pull/2650)  
+  **What was fixed**: Robust error handling for missing/unreadable retry config files.  
+  **Who benefits**: All users.  
+  **Impact**: Prevents driver errors due to application file path issues.  
+
+
+- **Suppressed CodeQL warnings for crypto usages** [#2677](https://github.com/microsoft/mssql-jdbc/pull/2677)  
+  **What was fixed**: Suppressed CodeQL security warnings for cryptographic use cases.  
+  **Who benefits**: Reviewers using CodeQL.  
+  **Impact**: Maintains compatibility and audit clarity.  
+
+
+- **Batch insert fix for case-sensitive column name mismatch** [#2695](https://github.com/microsoft/mssql-jdbc/pull/2695)  
+  **What was fixed**: `executeBatch()` now respects case sensitivity of collations when matching column names.  
+  **Who benefits**: Applications using case-sensitive/case-insensitive schemas.  
+  **Impact**: Avoids metadata retrieval failures during batch inserts.  
+
+
 ## [12.10.0] Stable Release
 ### Added
 - Added provision to set SQLServerBulkCopy options in PreparedStatement [#2555](https://github.com/microsoft/mssql-jdbc/pull/2555)

README.md

@@ -83,7 +83,7 @@ We're now on the Maven Central Repository. Add the following to your POM file to
 <dependency>
 	<groupId>com.microsoft.sqlserver</groupId>
 	<artifactId>mssql-jdbc</artifactId>
-	<version>12.10.0.jre11</version>
+	<version>13.1.0.jre11-preview</version>
 </dependency>
 ```
 The driver can be downloaded from [Microsoft](https://aka.ms/downloadmssqljdbc). For driver version 12.1.0 and greater, please use the jre11 version when using Java 11 or greater, and the jre8 version when using Java 8.
@@ -94,7 +94,7 @@ To get the latest version of the driver, add the following to your POM file:
 <dependency>
 	<groupId>com.microsoft.sqlserver</groupId>
 	<artifactId>mssql-jdbc</artifactId>
-	<version>12.10.0.jre11</version>
+	<version>13.1.0.jre11-preview</version>
 </dependency>
 ```
 
@@ -129,7 +129,7 @@ Projects that require either of the two features need to explicitly declare the
 <dependency>
 	<groupId>com.microsoft.sqlserver</groupId>
 	<artifactId>mssql-jdbc</artifactId>
-	<version>12.10.0.jre11</version>
+	<version>13.1.0.jre11-preview</version>
 	<scope>compile</scope>
 </dependency>
 
@@ -147,7 +147,7 @@ Projects that require either of the two features need to explicitly declare the
 <dependency>
 	<groupId>com.microsoft.sqlserver</groupId>
 	<artifactId>mssql-jdbc</artifactId>
-	<version>12.10.0.jre11</version>
+	<version>13.1.0.jre11-preview</version>
 	<scope>compile</scope>
 </dependency>
 
@@ -174,7 +174,7 @@ When setting 'useFmtOnly' property to 'true' for establishing a connection or cr
 <dependency>
 	<groupId>com.microsoft.sqlserver</groupId>
 	<artifactId>mssql-jdbc</artifactId>
-	<version>12.10.0.jre11</version>
+	<version>13.1.0.jre11-preview</version>
 </dependency>
 
 <dependency>

build.gradle

@@ -11,8 +11,8 @@
 
 apply plugin: 'java'
 
-version = '12.10.0'
-def releaseExt = ''
+version = '13.1.0'
+def releaseExt = '-preview'
 def jreVersion = ""
 def testOutputDir = file("build/classes/java/test")
 def archivesBaseName = 'mssql-jdbc'

mssql-jdbc_auth_LICENSE

@@ -1,5 +1,5 @@
 MICROSOFT SOFTWARE LICENSE TERMS
-MICROSOFT JDBC DRIVER 12.10.0 FOR SQL SERVER
+MICROSOFT JDBC DRIVER 13.1.0 FOR SQL SERVER
 
 These license terms are an agreement between you and Microsoft Corporation (or one of its affiliates). They apply to the software named above and any Microsoft services or software updates (except to the extent such services or updates are accompanied by new or additional terms, in which case those different terms apply prospectively and do not alter your or Microsoft’s rights relating to pre-updated software or services). IF YOU COMPLY WITH THESE LICENSE TERMS, YOU HAVE THE RIGHTS BELOW.  BY USING THE SOFTWARE, YOU ACCEPT THESE TERMS.
 

pom.xml

@@ -5,7 +5,7 @@
 	<modelVersion>4.0.0</modelVersion>
 	<groupId>com.microsoft.sqlserver</groupId>
 	<artifactId>mssql-jdbc</artifactId>
-	<version>12.10.0</version>
+	<version>13.1.0</version>
 	<packaging>jar</packaging>
 	<name>Microsoft JDBC Driver for SQL Server</name>
 	<description>
@@ -52,7 +52,7 @@
 			Default testing enabled with SQL Server 2019 (SQLv15) -->
 		<excludedGroups>xSQLv12,xSQLv15,NTLM,MSI,reqExternalSetup,clientCertAuth,fedAuth,kerberos,vectorTest</excludedGroups>
 		<!-- Use -preview for preview release, leave empty for official release. -->
-		<releaseExt></releaseExt>
+		<releaseExt>-preview</releaseExt>
 		<!-- Driver Dependencies -->
 		<org.osgi.core.version>6.0.0</org.osgi.core.version>
 		<azure-security-keyvault-keys.version>4.9.2</azure-security-keyvault-keys.version>

src/main/java/com/microsoft/sqlserver/jdbc/SQLJdbcVersion.java

@@ -6,16 +6,16 @@
 package com.microsoft.sqlserver.jdbc;
 
 final class SQLJdbcVersion {
-    static final int MAJOR = 12;
-    static final int MINOR = 10;
+    static final int MAJOR = 13;
+    static final int MINOR = 1;
     static final int PATCH = 0;
     static final int BUILD = 0;
     /*
      * Used to load mssql-jdbc_auth DLL.
      * 1. Set to "-preview" for preview release.
      * 2. Set to "" (empty String) for official release.
      */
-    static final String RELEASE_EXT = "";
+    static final String RELEASE_EXT = "-preview";
 
     private SQLJdbcVersion() {
         throw new UnsupportedOperationException(SQLServerException.getErrString("R_notSupported"));

src/samples/adaptive/pom.xml

@@ -15,7 +15,7 @@
 		<dependency>
 			<groupId>com.microsoft.sqlserver</groupId>
 			<artifactId>mssql-jdbc</artifactId>
-			<version>12.10.0.jre11</version>
+			<version>13.1.0.jre11-preview</version>
 		</dependency>
 	</dependencies>
 	<profiles>

src/samples/alwaysencrypted/pom.xml

@@ -15,7 +15,7 @@
 		<dependency>
 			<groupId>com.microsoft.sqlserver</groupId>
 			<artifactId>mssql-jdbc</artifactId>
-			<version>12.10.0.jre11</version>
+			<version>13.1.0.jre11-preview</version>
 		</dependency>
 	</dependencies>
 	<profiles>

src/samples/azureactivedirectoryauthentication/pom.xml

@@ -14,7 +14,7 @@
 		<dependency>
 			<groupId>com.microsoft.sqlserver</groupId>
 			<artifactId>mssql-jdbc</artifactId>
-			<version>12.10.0.jre11</version>
+			<version>13.1.0.jre11-preview</version>
 		</dependency>
 	</dependencies>
 	<profiles>

src/samples/connections/pom.xml

@@ -14,7 +14,7 @@
 		<dependency>
 			<groupId>com.microsoft.sqlserver</groupId>
 			<artifactId>mssql-jdbc</artifactId>
-			<version>12.10.0.jre11</version>
+			<version>13.1.0.jre11-preview</version>
 		</dependency>
 	</dependencies>
 	<profiles>