Download Release Notes Changelog

Release date: 11 Sep 2025

MariaDB Connector/J 3.5.6 is a Stable (GA) release.

Notable changes

• Implemented rewriteBatchStatements functionality ()

• Added server prepared statement fallback to client prepared statements ()

Bugs Fixed

• Corrected cache enablement to match 2.x behavior ()

• Added table name metadata support for MariaDB 12.1 following ()

• Fixed support for multiple commands in the initSql configuration option ()

• Fixed Connection#isValid(int timeout) to properly respect the timeout parameter when network connectivity is lost ()

Changelog

For a complete list of changes made in MariaDB Connector/J 3.5.6, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 27 Mar 2025

MariaDB Connector/J 3.4.2 is a Stable (GA) release.

Bugs Fixed

• : Fixed issue with incorrect statements.isClosed value after closing connection

• : Prevented NPE (Null Pointer Exception) after reconnection failure in high availability configurations

• : Disabled BULK operations when no parameters are present

Changelog

For a complete list of changes made in MariaDB Connector/J 3.4.2, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 27 Mar 2025

MariaDB Connector/J 3.3.4 is a Stable (GA) release.

Bugs Fixed

• : Fixed issue with incorrect statements.isClosed value after closing connection

• : Prevented NPE (Null Pointer Exception) after reconnection failure in high availability configurations

• : Disabled BULK operations when no parameters are present

Changelog

For a complete list of changes made in MariaDB Connector/J 3.3.4, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 19 Dec 2023

MariaDB Connector/J 3.3.2 is a Stable (GA) release, and will replace 3.2 as the maintenance releases.

Bugs Fixed

• new option returnMultiValuesGeneratedIds for connector 2.x compatibility, so getGeneratedKeys() return all ids of multi-value inserts

• regression caussing ClassCastException on DatabaseMetaData when use with option defaultFetchSize set

• Metadata.getPrimaryKeys table comparison using like in place of strict equality

• ensuring batch parameter are cleared after SQL Failure

• NullPointerException when Calling getGeneratedKeys() after an SQL Failure

• Ensuring reseting result for getUpdateCount() after an SQL Failure

• ensuring BULK command not used when using INSERT ON DUPLICATE KEY UPDATE in order to always have unique affected rows by default

• wrong decoding for Resultset.getByte() results for binary varchar fields

• ensuring never having NPE in OkPacket when setting auto commit

• Inconsistency in Behavior of PreparedStatement After closeOnCompletion() Between MariaDB and MySQL Connectors

• Metadata getTableTypes result was not ordered by TABLE_TYPE

Changelog

For a complete list of changes made in MariaDB Connector/J 3.3.2, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 1 May 2023

MariaDB Connector/J 3.1.4 is a Stable (GA) release.

Bugs fixed

• wrong Resultset.wasNull() for zero-date timestamps

• getBlob on TEXT columns throw Exception

• Error response during Bulk execution might result in connection wrong state

• When some numeric data types are set to UNSIGNED, ResultSetMetaData.getColumnTypeName() does not return UNSIGNED

Changelog

For a complete list of changes made in MariaDB Connector/J 3.1.4, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 11 Jan 2023

MariaDB Connector/J 3.0.10 is a Stable (GA) release.

Bugs Fixed

• Connector/J doesn't set SSL cap bit in Handshake Response Packet

• timezone=auto option failure on non-fixed-offset zone machine

• Compatibility for deprecated arguments is case sensitive now

Changelog

For a complete list of changes made in MariaDB Connector/J 3.0.10, with links to detailed information on each push, see the .

Download Release Notes Changelog

Release date: 29 Jun 2022

MariaDB Connector/J 2.7.6 is a Stable (GA) release.

Bugs Fixed

• avoid race condition provoking locking issue

Changelog

For a complete list of changes made in MariaDB Connector/J 2.7.6, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 11 Jan 2023

MariaDB Connector/J 3.1.1 is a Stable (GA) release.

Bugs fixed

• 3.0.10 bug fix:

  • Connector/J doesn't set SSL cap bit in Handshake Response Packet

  • timezone=auto option failure on non-fixed-offset zone machine

  • Compatibility for deprecated arguments is case sensitive now

• org.mariadb.jdbc.client.socket.impl.PacketWriter.writeAscii() broken in 3.1.0

Changelog

For a complete list of changes made in MariaDB Connector/J 3.1.1, with links to detailed information on each push, see the .

Download Release Notes Changelog

Release date: 25 Aug 2023

MariaDB Connector/J 2.7.10 is a Stable (GA) release.

Bugs Fixed

• Ensure setting connectTimeout as timeout for socket timeout until connection is done. This permit to set a connectTimeout, while socketTimeout can still be set to 0

Changelog

For a complete list of changes made in MariaDB Connector/J 2.7.10, with links to detailed information on each push, see the .

Download Release Notes Changelog

Release date: 11 Aug 2021

MariaDB Connector/J 2.7.4 is a Stable (GA) release.

Bugs Fixed

• getImportedKeys/getTables regression returning an empty resultset for null/empty catalog

• Ensure socket state when SocketTimeout occurs

• IndexOutOfBoundsException when executing prepared queries using automatic key generation in parallel

• MariaDbPoolDataSource leaks connections when the mariadb server restarts

• DatabaseMetaData.getColumns regression causing TINYINT(x) with x > 1 to return BIT type in place of TINYINT

• CallableStatement using function throw wrong error on getter

Changelog

For a complete list of changes made in MariaDB Connector/J 2.7.4, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 20 Feb 2024

MariaDB Connector/J 3.3.3 is a Stable (GA) release.

Bugs Fixed

• regression: nonparameterized batch fails

• Error using PrepareStatement.setURL with null url

• Improve message when reaching socket timeout during connection initial commands

Changelog

For a complete list of changes made in MariaDB Connector/J 3.3.3, with links to detailed information on each push, see the .

Download Release Notes Changelog

Release date: 19 Jan 2022

MariaDB Connector/J 2.7.5 is a Stable (GA) release.

Notable Change

• The connection id has been added to important log messages for easier correlation of these log messages with MariaDB Server logs

• The connect does not enable session_track_schema anymore when connecting to the server, as this is the server default already

Bugs Fixed

• Error message “[1036] Unknown variable: session_track_schema” when MariaDB Connector/J connects to MariaDB Xpand

• Connection Pools do not validate other connections before use when the socket fails

• Options useBatchMultiSend and usePipelineAuth are disabled without reason for RDS

Changelog

For a complete list of changes made in MariaDB Connector/J 2.7.5, with links to detailed information on each push, see the .

Release Notes | Changelog |

Release date: 9 Dec 2020

MariaDB Connector/J 1.7.5 is a Stable (GA) release.

This version contains breaking changes that weren't expect in a corrective release. Correction have been done with 1.7.6 version, that is the 1.7.4 version + corrections.

Note: This page describes features in an unreleased version of MariaDB Connector/J.Unreleased means there are no official packages or binaries available for download which contain the features. The source code is available on GitHub.

Release date: 1 Jul 2025

MariaDB Connector/J 3.5.4 is a (GA) release.

Notable Changes

| Release Notes | |

Release date: 22 Mar 2023

MariaDB Connector/J 3.1.3 is a (GA) release.

Bugs fixed

| Release Notes | |

Release date: 8 Nov 2023

MariaDB Connector/J 3.3.0 is a (GA) release, and will replace 3.2 as the maintenance releases.

Notable Changes

Release date: 17 Dec 2025

MariaDB Connector/J 3.5.7 is a (GA) release.

Notable changes

| Release Notes | |

Release date: 29 Jun 2022

MariaDB Connector/J 3.0.6 is a (GA) release.

Notable Changes

Release date: 08 Nov 2023

MariaDB Connector/J 2.7.11 is a (GA) release.

Bugs Fixed

| Release Notes | |

Release date: 11 Feb 2025

MariaDB Connector/J 3.5.2 is a (GA) release.

Notable change

| Release Notes | |

Release date: 25 May 2022

MariaDB Connector/J 3.0.5 is a (GA) release.

Notable Changes

| Release Notes | |

Release date: 11 Aug 2021

MariaDB Connector/J 3.0.1 is a (Beta) release.

Release date: 20 Feb 2024

MariaDB Connector/J 2.7.12 is a (GA) release.

Bugs Fixed

| Release Notes | |

Release date: 24 Jan 2023

MariaDB Connector/J 3.1.2 is a (GA) release.

Notable Changes

| Release Notes | |

Release date: 27 Jan 2020

MariaDB Connector/J 2.5.4 is a (GA) release.

| Release Notes | |

Release date: 20 Mar 2020

MariaDB Connector/J 2.6.0 is a (GA) release.

Release date: 22 Mar 2023

MariaDB Connector/J 2.7.9 is a (GA) release.

Bugs Fixed

| Release Notes | |

Release date: 29 Nov 2023

MariaDB Connector/J 3.3.1 is a (GA) release, and will replace 3.2 as the maintenance releases.

Bugs Fixed

| Release Notes | |

Release date: 8 Jan 2020

MariaDB Connector/J 2.5.3 is a (GA) release.

Notable Updates

| Release Notes | |

Release date: 14 Mar 2018

MariaDB Connector/J 2.2.3 is a (GA) release.

Bug Fixes

Release date: 24 Jan 2023

MariaDB Connector/J 2.7.8 is a (GA) release.

Bugs Fixed

| Release Notes | |

Release date: 23 Jul 2020

MariaDB Connector/J 2.6.2 is a (GA) release.

| Release Notes | |

Release date: 16 Oct 2019

MariaDB Connector/J 2.5.1 is a release.

| Release Notes | |

Release date: 22 Dec 2017

MariaDB Connector/J 2.2.1 is a (GA) release.

• [] provide support for authentication plugin ed25519

| Release Notes | |

Release date: 18 Sep 2019

MariaDB Connector/J 2.4.4 is a (GA) release.

Bugs

| Release Notes | |

Release date: 19 Jul 2018

MariaDB Connector/J 2.2.6 is a (GA) release.

Minor change:

| Release Notes | |

Release date: 20 Feb 2018

MariaDB Connector/J 2.2.2 is a (GA) release.

Bug Fixes

| Release Notes | |

Release date: 22 Nov 2019

MariaDB Connector/J 2.5.2 is a (GA) release.

| Release Notes | |

Release date: 14 May 2018

MariaDB Connector/J 2.2.4 is a (GA) release.

Bug Fixes

| Release Notes | |

Release date: 8 Nov 2022

MariaDB Connector/J 3.0.9 is a (GA) release.

Notable Changes

| Release Notes | |

Release date: 10 Dec 2020

MariaDB Connector/J 1.7.6 is a (GA) release.

Reporting correction/contribution to java 7 supported version

Bugs Fixed

Download | Release Notes | Changelog |

Release date: 4 May 2021

MariaDB Connector/J 3.0.0 is a Alpha (Alpha) release.

Notable Changes

This version is a complete rewrite of the Java driver. The goal being to have a more performant, easy to read, extendable, small driver.

• Complete rewrite, code simplification / clarification, reduced size (15%), more than 90% coverage tested.

• Performance Improvements:

  • Prepare and execution are now using pipelining when using option useServerPrepStmts

  • Performance enhancement with

SSL configuration

New Options :

The options useSsl, trustServerCertificate, and disableSslHostnameVerification still exist, but sslMode allows for easier configuration.

Easy logging

If using slf4j, just enable the package "org.mariadb.jdbc" log.

• Level ERROR will log connection errors

• Level WARNING will log query errors

• Level DEBUG will log queries

If not using slf4j, console logging will be used.

If you really want to use the JDK logger, the System property "mariadb.logging.fallback" set to JDK will indicate to use common logging.

Failover

The Failover implementation now permits redoing transactions : when creating a transaction, all commands will be cached, and can be replayed in case of failover.

This functionality can be enabled using the option transactionReplay.

This is not enabled by default, because it requires that the application avoid using non-idempotent commands.

Example:

Allow setup of socket TCP_KEEPIDLE, TCP_KEEPCOUNT, TCP_KEEPINTERVAL

Equivalent options are tcpKeepIdle, tcpKeepCount, tcpKeepInterval

Because these are available only with Java 11, setting these options with java < 11 will have no effect.

permit authentication plugin restriction

New Options :

example setting restrictedAuth to "mysql_native_password,client_ed25519,auth_gssapi_client", only those plugins can be use. If server return ask for an authentication plugin not listed in restrictedAuth, driver will throw an exception.

Extendable

The driver is built with a Service Provider Interface (SPI), permitting easy ways to extend the driver.

Possible extensions:

• org.mariadb.jdbc.codec.Codec : Allows encoding/decoding types

• org.mariadb.jdbc.plugin.authentication.AuthenticationPlugin : Allows authentication plugin additions. Defaults are "mysql_clear_password", "auth_gssapi_client", "client_ed25519", "mysql_native_password", "dialog" (PAM), and "caching_sha2_password"

• org.mariadb.jdbc.plugin.credential.CredentialPlugin : Allows login/password retrieval. Defaults are "AwsIamCredentialPlugin" to permit retrieve a temporary IAM authentication, "EnvCredentialPlugin" to get environment authentication, and "PropertiesCredentialPlugin" to get authentication info from java property

Bugs Fixed

• - includeThreadDumpInDeadlockExceptions always includes the thread dump, even when it is not a deadlock exception

• - Properties parameters that differ from string not taken in account

Changelog

For a complete list of changes made in MariaDB Connector/J 3.0.0, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 25 Mar 2022

MariaDB Connector/J 3.0.4 is a Stable (GA) release.

Bugs Fixed

• DatabaseMetadata#getTables throws a syntax error if a NULL value is used for tableNamePattern

• A DECIMAL overflow for long/int/short is not throwing an exception

• A NULL value returned for a column can result in java.lang.IllegalArgumentException: Unexpected data type NULL

• The authentication is restricted to the methods 'mysql_native_password,client_ed25519,auth_gssapi_client' instead of allowing all supported methods, if the option restrictedAuth is not set (default NULL).

• 32 bit value returned instead of a 64 bit value for generated id / updated rows

• When the load-balancing HA mode is used a host is not used anymore after a connection failed, even if a connection would be possible again.

• Connection.getMetaData() returns values of type MariaDbClob instead of the expected type String

• metadata.getColumnTypeName() returns the values with a wrong types

• A connection fails if the password is set before the username for MariaDbDataSource

• The login packet has non-standard length information for the attributes, which can result in issues when using wireshark.

• When using failover the definition of retriesAllDown is ignored when trying to reconnect

• Updates of rows is not possible for storage engines which do not provide the metadata information for primary columns

Install and Upgrade

• missing OSGI metadata is missing

Changelog

For a complete list of changes made in MariaDB Connector/J 3.0.4, with links to detailed information on each push, see the .

Download Release Notes Changelog

Release date: 23 Nov 2020

MariaDB Connector/J 2.7.1 is a Stable (GA) release.

Notable changes

• Byte array parameters are now sent as long data

Bugs Fixed

• use of BULK batch is conditioned by capability, not checking server version

• GSS Imports set in OSGI Bundle

• Wrong exception message when rewriteBatchedStatements is enabled

• ResultSetMetaData::getColumnTypeName() returns incorrect type name for LONGTEXT

Minor

• test suite now test MariaDB Cloud with replication setting

• have a 'replica' alias for 'slave' connection option

Changelog

For a complete list of changes made in MariaDB Connector/J 2.7.1, with links to detailed information on each push, see the .

Download Release Notes Changelog

Release date: 29 Jan 2021

MariaDB Connector/J 2.7.2 is a Stable (GA) release.

Bugs Fixed

• NPE at UpdatableResultSet#close

• driver now doesn't close connection caused java.io.NotSerializableException as a result of incorrect data bind to a prepared statement parameter

• MariaDbResultSetMetaData#getPrecision(int) now returns correct length for character data

• metadata getBestRowIdentifier incompatibility with MySQL 8 correction

• ON DUPLICATE KEY detection failed when using new line

Changelog

For a complete list of changes made in MariaDB Connector/J 2.7.2, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 20 Sep 2022

MariaDB Connector/J 3.0.8 is a Stable (GA) release.

Notable Changes

• improve client side prepared parameter substitution

Bugs Fixed

• regression in 3.x when using option galeraAllowedState resulting in an IndexOutOfBoundsException

• 2nd failover reconnection ignores default database/schema setting when not set by connection string

• replication configuration always use 1st replica on 3.0

• BatchUpdateException doesn't inherited the SQLState & vendorCode from the cause SQL exception

Changelog

For a complete list of changes made in MariaDB Connector/J 3.0.8, with links to detailed information on each push, see the .

Download Release Notes Changelog

Release date: 17 Dec 2025

MariaDB Connector/J 2.7.13 is a Stable (GA) release.

Bugs Fixed

• Fixed intermittent NullPointerException when calling prepareStatement

• Fixed possible ArrayIndexOutOfBoundsException when using CallableStatement

• Fixed Android compatibility issue: Pattern CANON_EQ flag not supported

• Fixed NullPointerException in MariaDbDataSource when setLoginTimeout(0) has been called

• Fixed ResultSetMetaData precision for signed BIGINT (was reported as 20)

• report 3.x correction: metadata table name addition for 12.1

• report 3.x correction: Handle authentication plugin multi-exchange prefix (0x01) introduced in MDEV-37554

• report 3.x correction: MariaDbClob fails to compile with JDK 26+

Changelog

For a complete list of changes made in MariaDB Connector/J 2.7.13, with links to detailed information on each push, see the .

Download Release Notes Changelog

Release date: 25 Sep 2020

MariaDB Connector/J 2.7.0 is a Stable (GA) release.

Notable Changes

• normalization of resultset getDate/getTime of timestamp field.

• DatabaseMetadata.getBestRowIdentifier and getMaxProcedureNameLength correction

• Table with primary key with DEFAULT function can be inserted for 10.5 servers

• MySQLPreparedStatement.setObject can now handle java.lang.Character type

Bugs Fixed

• maxFieldSize string truncation occurs on bytes length, not character length

• Correcting possible Get Access Denied error if using multiple classloader

• setConfiguration not being called on classes that extend ConfigurableSocketFactory

• Switched position of REMARKS and PROCEDURE_TYPE in the getProcedures result

Changelog

For a complete list of changes made in MariaDB Connector/J 2.7.0, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 25 Aug 2023

MariaDB Connector/J 3.0.11 is a Stable (GA) release.

Bugs Fixed

• correcting 3.0.10 incompatibility with java 8

Changelog

For a complete list of changes made in MariaDB Connector/J 3.0.11, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 7 Jun 2017

MariaDB Connector/J 2.0.2 is a Stable (GA) release.

Bug

• - DataSource connectTimeout is in second, but was set on socket timeout that is in milliseconds

• - option "useServerPrepStmts" : Possible Buffer overrun reading ResultSet

• - option "rewriteBatchedStatements" : Error when executing SQL contains "values" that aren't inserts

• - option "usePipelineAuth" : incompatibility with aurora. Now automatically disabled when aurora is detected

• - compatibility : ArrayIndexOutOfBoundsException on connect to MySQL 5.1.73

• - compatibility : Access denied error on connect to MySQL 5.1.73

• - metadata : DatabaseMetadata.getPrimaryKeys() return a null value for PK_NAME, must always be 'PRIMARY'

• - metadata : Wrong content of DEFERRABILITY column in MariaDbDatabaseMetaData

• - No timeout exception on client PrepareStatement

• - log: javax.transaction.xa.XAException message error truncated ( near '0x )

Task

• - Change CI tests to use maxscale 2.1 version

• - Connection.setNetworkTimeout don't throw exception if no executor

• - Use java.net.URL to read keyStore and trustStore again

Download | Release Notes | Changelog |

Release date: 4 Aug 2022

MariaDB Connector/J 3.0.7 is a Stable (GA) release.

Bugs Fixed

• SQLDataException reading DATA_TYPE on DatabaseMetaData.getTypeInfo() after 3.0.4

• Permit specific Statement.setLocalInfileInputStream for compatibility

• Version 3.0.0 returns String for VARBINARY instead of byte[] as 2.7.6 did

• Binary column read as String

• Setting timezone=UTC result in SQLSyntaxErrorException

• Regression: binary(16) is returned as String by getObject()

• Version 3.x rejects previously accepted boolean string parameter for BOOLEAN field

Changelog

For a complete list of changes made in MariaDB Connector/J 3.0.7, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 27 Jun 2017

MariaDB Connector/J 2.0.3 is a Stable (GA) release.

Bug

• - when useServerPrepStmts is not set, the PREPARE statement must not be cached.

• - Handle PrepareStatement.getParameterMetaData() if query cannot be PREPAREd

• - escape string correction for big query

Download | Release Notes | Changelog |

Release date: 18 Mar 2019

MariaDB Connector/J 2.4.1 is a Stable (GA) release.

Evolutions

• [misc] enabled running of 'SHOW ENGINE INNODB STATUS' for error code 1213 (@mtykhenko)

• [misc] reduce mutex using select @@innodb_read_only for aurora (@matsuzayaws)

Bugs

• [misc] updating checkstyle version dependency

• [misc] permit using SSL on localsocket

• [misc] java PID using java 9 ProcessHandle if existing, relying on JNA if present

• : addition of option "useMysqlMetadata" to permit MySQL meta compatibility

Download Release Notes Changelog

Release date: 8 Nov 2022

MariaDB Connector/J 2.7.7 is a Stable (GA) release.

Bugs Fixed

• GSSAPI authentication might result in connection reset

• DatabaseMetaData.getImportedKeys should return real value for PK_NAME column

• avoid splitting BULK command into multiple commands in case of prepareStatement.setNull() use

• correcting possible NPE when using statement.cancel() that coincide with statement.close() in another thread

• Socket file descriptors are leaked after connecting with unix socket if DB is not up running

Changelog

For a complete list of changes made in MariaDB Connector/J 2.7.7, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 14 Mar 2018

MariaDB Connector/J 1.7.3 is a Stable (GA) release.

Bug Fixes

• [] possible hang indefinitely using master/slave configuration and failover occur

• [] erroneous transaction state when first command result as error

• [] using allowMasterDownConnection option can lead to NPE when using setReadOnly()

• [] using option 'allowMasterDownConnection' won't permit to connect if master is down

• [] Connection.isValid() must be routed to Master and Slave connections to avoid any server timeout

Download | Release Notes | Changelog |

Release date: 6 Sep 2017

MariaDB Connector/J 2.1.1 is a Stable (GA) release.

Bug

• [] Updatable result-set possible NPE when same field is repeated.

• [] ResultSet method wasNull() always return true after a call on a "null-date" field binary protocol handling

• [] Permit using updatable result-set when fetching

• [] Add legacy SSL certificate Hostname verification with CN even when SAN are set

• [] Improve MariaDB driver stability in case JNA errors

Misc

• correct typo in error message when setting wrong parameter

• add trace to HostnameVerifier implementation

• handling connection error when no database is provided

Download | Release Notes | Changelog |

Release date: 30 May 2018

MariaDB Connector/J 2.2.5 is a Stable (GA) release.

Minor change:

• [] Add server hostname to connection packet for proxy

• [] handle support for mysql 8.0 tx_isolation replacement by transaction_isolation

• [] Create option to configure DONOR/DESYNCED Galera nodes to be unavailable for load-balancing : Usually, Connection.isValid just send an empty packet to the server, and server sends a small response to ensure connectivity. When a new option "useBulkStmts" option is set, the connector will ensure galera server state ("wsrep_local_state" correspond to allowed values (4 = sync mode). see to now more.

Bug correction:

• [] Connection using "replication" Parameters fail when no slave is available

• [] Newlines where breaking calling stored procedures

• [] Using getDate with function DATE_ADD() with parameter using string format where return wrong result using the binary protocol

• [] Option "allowMasterDownConnection" improvement on connection validation and Exceptions on master down

Download | Release Notes | Changelog |

Release date: 26 Sep 2017

MariaDB Connector/J 2.1.2 is a Stable (GA) release.

Bug

• [] Batch result-set return array correction when DELETE statement when bulk option is used

• [] better error message getting metadata information when SQL syntax is wrong

• [] Resultset.last() return wrong value if resultset has only one result

• [] Error executing LOAD DATA LOCAL INFILE when file is larger than max_allowed_packet

Misc

• ensuring Connection.isValid(timeout) always respect timeout value

| Release Notes | |

Release date: 20 Nov 2024

MariaDB Connector/J 3.5.1 is a (GA) release.

The MariaDB Connector/J 3.5 release series is replacing the maintenance releases for the 3.4 release series, as the new release series is fully compatible with 3.4.

Notable changes

| Release Notes | |

Release date: 24 Oct 2024

MariaDB Connector/J 3.5.0 is a (GA) release.

The MariaDB Connector/J 3.5 release series is replacing the maintenance releases for the 3.4 release series, as the new release series is fully compatible with 3.4.

Notable changes

| Release Notes | |

Release date: 23 Jun 2020

MariaDB Connector/J 2.6.1 is a (GA) release.

Notable Updates

| Release Notes | |

Release date: 15 Nov 2022

MariaDB Connector/J 3.1.0 is a (GA) release.

Performance

Other than features, connector permit significant performance improvements, reaching the same level of performance than c connector

Most significant change are :

| Release Notes | |

Release date: 9 Nov 2017

MariaDB Connector/J 2.2.0 is a (GA) release.

Features

Release date: 12 May 2021

MariaDB Connector/J 2.7.3 is a (GA) release.

Notable Change

| Release Notes | |

Release date: 30 May 2018

MariaDB Connector/J 1.7.4 is a (GA) release.

Minor change:

| Release Notes | |

Release date: 17 Jun 2019

MariaDB Connector/J 2.4.2 is a (GA) release.

Notes

| Release Notes | |

Release date: 20 Feb 2018

MariaDB Connector/J 1.7.2 is a (GA) release.

Bug Fixes

| Release Notes | |

Release date: 5 Aug 2019

MariaDB Connector/J 2.4.3 is a (GA) release.

Notes

New option blankTableNameMeta permit to have Resultset metadata getTableName methods always return blank in place of returning real table name as JDBC indicate. This is for ease migration from Oracle since Oracle driver always returns an empty string.

Download | Release Notes | Changelog |

Release date: 25 Aug 2023

MariaDB Connector/J 3.2.0 is a Stable (GA) release. It is replacing 3.1 as the maintenance releases.

Notable Changes

Batch Bulk behavior

Bulk batching enabled by default (option useBulkStmts) with permit super fast batching, but batch return array of update counts with Statement.SUCCESS_NO_INFO values. The problem is that application using optimistic locking fails, expecting exact return value.

useBulkStmts is now defaulting to false, with the addition of a new option useBulkStmtsForInserts, enabled by default permit to enable bulk for insert command only. This permit to have return values in batching return value, for all cases, permitting optimistic behavior.

This default values are more appropriate for all kind of application. If application doesn't use optimistic locking, enabling useBulkStmts is then more appropriate, because UPDATE and DELETE commands in batch will then use faster BULK implementation.

Maxscale improvement

When using maxscale 23.08.0+, when a maxscale node fails, connector will now priorize reconnection to the maxscales nodes having less connections, to ensure connections repartition after failover. This allows a faster return to normal

other features

• Implement databaseTerm option for mysql compatibility

• adding option useLocalSessionState to permit avoiding queries when application only use JDBC methods.

Bugs Fixed

• LOAD DATA INFILE is broken on windows

• getGeneratedKeys after batch will not return all generated id's if first batch command return no generated id.

• maridb Java connector sslMode=verify-ca complaining unable to find trust certificate.

• Multiple session system variables parsing fails

Changelog

For a complete list of changes made in MariaDB Connector/J 3.2.0, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 17 May 2024

MariaDB Connector/J 3.4.0 is a Stable (GA) release, and replaces 3.3 as the maintenance releases.

Notable Changes

ZERO-CONFIGURATION SSL ENCRYPTION

Using SSL (a more correct term would be TLS, but in reality SSL is more commonly used) has been simplified with . Before version 11.4, proper SSL configuration required multiple manual steps for the server and all the clients connecting to it.

For MariaDB Connector/J before 3.4 to establish an SSL encrypted connection, or a MariaDB Server release series previous to 11.4, three options can be used:

• Have server certificates generated with trusted Certificate Authorities (CA), using a configuration like: sslMode=verify-full

• Configure the connector using a server certificate, like: sslMode=verify-full&serverSslCert=file:///server-cert.pem

• Disable the verification of the SSL certificate, which is insecure and not recommended, using a configuration like: sslMode=trust

For MariaDB Connector/J 3.4 to establish an SSL encrypted connection to MariaDB Server 11.4, enabling SSL does not require any special configuration apart from using sslMode=verify-full. The connector doesn't need to know the server certificate anymore, as long as the password is not empty.

Changes to Timezone Configuration Options for TIMESTAMPS

The MariaDB Connector/J versions before 3.4 provide a single "timezone" option for working with different time zones for clients and servers. While this functionality remains compatible, it's now separated into two distinct settings:

• connectionTimeZone

• forceConnectionTimeZoneToSession

There are now 3 options that control timestamps behavior in the java connector:

• connectionTimeZone: (LOCAL | SERVER | ) This option defines the connection's time zone. LOCAL retrieves the JVM's default time zone, SERVER fetches the server's global time zone upon connection creation, and allows specifying a server time zone without requesting it during connection establishment.

• forceConnectionTimeZoneToSession: (true | false) This setting dictates whether the connector enforces the connection time zone for the session.

• preserveInstants: (true | false) This option controls whether the connector converts Timestamp values to the connection's time zone.

While remaining compatible with previous versions, this permits more flexibility when handling timezone difference scenarios. See for detailed information.

Add support for connection redirection

Since , the server has a new system variable redirect_url to provide a connection string using the forma mariadb/mysql://[<user>[:<password>]@]<host>[:<port>]/[<db>[?<opt1>=<value1>[&<opt2>=<value2>]]].

When set, all existing connections will be redirected to the designated URL values when appropriate. A connection will only be redirected when no transaction is active.

Example for enabling the redirection:set @@global.redirect_url="mariadb://somehost:3306/"

The redirection feature is enabled by default. It can be disabled by setting the new option permitRedirect to FALSE, which will result in ignoring the redirection URL.

Reduced overhead for issuing queries for retrieving and setting isolation level metadata

When session tracking is supported by the MariaDB Server release series, Connection.getTransactionIsolation() won’t query the server as the current state is already known from the session tracking information. Connection.setTransactionIsolation will skip the query to set the transaction isolation level if the server is already using the requested transaction isolation level.

Bugs Fixed

• Connector/J Version 3 Does Not Respect "nullCatalogMeansCurrent" Property

• Database connection failing on android

• MariaDB Connector 3 no longer supports query timeout with MySQL

• Inconsistency in Handling PreparedStatement.executeQuery() between MariaDB and MySQL Connectors

Changelog

For a complete list of changes made in MariaDB Connector/J 3.4.0, with links to detailed information on each push, see the .

Download | Release Notes | Changelog |

Release date: 31 July 2017

MariaDB Connector/J 2.1.0 is a Stable (GA) release.

Notable Changes

This version is a general availability (GA) release. (2.x version need java 8+)

Notable changes and additions

: verification of SSL Certificate Name Mismatch

When using ssl, driver check hostname against the server's identity as presented in the server's Certificate (checking alternative names or certificate CN) to prevent man-in-the-middle attack. Verification is disabled when the option "trustServerCertificate" is set.

A new option "disableSslHostnameVerification" permit to deactivate this validation.

- Galera validation

When configuration with multi-master, Connection.isValid() will not only validate connection, but host state (@@wsrep_cluster_status). A connection to a node that is not in primary mode will return false (meaning that in pool, connection will be discarded)

- ResultSet.update* methods implementation

ResultSet.update* methods aren't implemented statement using ResultSet.CONCUR_UPDATABLE are now able to update record. example:

- faster batch insert

Use dedicated protocol for batch insert when possible. (batch without Statement.RETURN_GENERATED_KEYS and streams) to have faster batch (significant only if server >= ).

A new option "useBulkStmts" permit to deactivate this functionality.

other evolution

• [] Connection.getCatalog() optimisation for 10.2+ server using new session_track_schema capabilities

• [] Failover handle automatic reconnection on KILL command

Bug

• [] isolation leak when using multiple pools on same VM on failover

• [] regression on aurora Connection Connection.isReadOnly()

• [] correcting issue that ended throwing "Unknown prepared statement handler given to mysqld_stmt_execute"

• [] return rounded numeric when querying on a decimal field in place of throwing an exception for compatibility