Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions connectors/mariadb-connector-j/about-mariadb-connector-j.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,8 @@ MariaDB Connector/J releases older than 1.2.0 may be compatible with server vers
To determine which MariaDB Connector/J release series would be best to use for each Java version, please see the following table:

| Java Version(s) | Recommended MariaDB Connector/J Release Series | JDBC Version |
| ------------------------------------------ | ----------------------------------------------------------------------------- | ------------ |
| Java 25, Java 21, Java 17, Java 11, Java 8 | MariaDB Connector/J 3.5, 3.4, 3.3\[[1](about-mariadb-connector-j.md#_note-0)] | JDBC 4.2 |
| ------------------------------------------ | ----------------------------------------------------------------------------- |--------------|
| Java 25, Java 21, Java 17, Java 11, Java 8 | MariaDB Connector/J 3.5, 3.4, 3.3\[[1](about-mariadb-connector-j.md#_note-0)] | JDBC 4.5 |
| Java 17, Java 11, Java 8 | MariaDB Connector/J 2.7 | JDBC 4.2 |

1. [↑](about-mariadb-connector-j.md#_ref-0) see parsec authentication restriction
Expand Down Expand Up @@ -456,7 +456,7 @@ See the [pool documentation](pool-datasource-implementation.md) for pool configu

#### **connectionAttributes**

* Description: When performance\_schema is active, permit to send server some client information in a key;value pair format (example: connectionAttributes=key1:value1,key2,value2).Those informations can be retrieved on server within tables performance\_schema.session\_connect\_attrs and performance\_schema.session\_account\_connect\_attrs.This can permit from server an identification of client/application
* Description: When performance\_schema is active, permit sending the server some client information in a key;value pair format (example: connectionAttributes=key1:value1,key2,value2).The information can be retrieved on the server in the tables performance\_schema.session\_connect\_attrs and performance\_schema.session\_account\_connect\_attrs. This can enable the server to identify the client/application
* Data Type: `string`
* Default Value: `null`
* Introduced: 1.4.0
Expand Down Expand Up @@ -937,7 +937,7 @@ using `Statement.setFetchSize(1000)` indicates that 1000 rows will be stored in
So, when the query has executed, 1000 rows will be in memory. After 1000 `ResultSet.next()`, the next 1000 rows will be stored in memory, and so on.

{% hint style="danger" %}
If another query is run on same connection while the resultset has not been completly read, the connector will fetch all remaining rows before executing the query. This can lead to still needing lots of memory. Recommendation is then to use another connection for simultaneous operations.
If another query is run on same connection while the resultset has not been completely read, the connector will fetch all remaining rows before executing the query. This can lead to still needing lots of memory. Recommendation is then to use another connection for simultaneous operations.
{% endhint %}

Note that the server usually expects clients to read off the result set relatively quickly. The [net\_write\_timeout](https://app.gitbook.com/s/SsmexDFPv2xG2OTyO5yV/server-management/variables-and-modes/server-system-variables#net_write_timeout) server variable controls this behavior (defaults to 60s).\
Expand Down Expand Up @@ -1026,7 +1026,7 @@ The driver has 3 default plugins :

This permits AWS database IAM authentication. The plugin generate a token using IAM credential and region. Token is valid for 15 minutes and cached for 10 minutes.

To use this credential authentication, com.amazonaws:aws-java-sdk-rds dependency must be registred in classpath. Implementation use SDK `DefaultAWSCredentialsProviderChain` and `DefaultAwsRegionProviderChain` to get IAM credential and region.\
To use this credential authentication, com.amazonaws:aws-java-sdk-rds dependency must be registered in classpath. Implementation use SDK `DefaultAWSCredentialsProviderChain` and `DefaultAwsRegionProviderChain` to get IAM credential and region.\
see [DefaultAWSCredentialsProviderChain](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/DefaultAWSCredentialsProviderChain.html) and [DefaultAwsRegionProviderChain](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/auth/DefaultAWSCredentialsProviderChain.html) to check how those information can be retrieved (environment variable / system properties, files, ...)

Example: `jdbc:mariadb://host/db?credentialType=AWS-IAM&useSsl&serverSslCert=/somepath/rds-combined-ca-bundle.pem`
Expand Down Expand Up @@ -1114,7 +1114,7 @@ Example of configuring "trace" level on driver for logback: file logback.xml in
</configuration>
```

Exemple of generated logs :
Example of generated logs :

```
11:47:04.613 [main] TRACE o.m.j.c.socket.impl.PacketWriter - send: conn=17532 (M)
Expand Down
2 changes: 2 additions & 0 deletions release-notes/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -1986,6 +1986,7 @@
* [Connector/J](connectors/java/README.md)
* [Connector/J All Releases](connectors/java/all-releases.md)
* [Connector/J 3.5 Release Notes](connectors/java/3.5/README.md)
* [Connector/J 3.5.7 Release Notes](connectors/java/3.5/3.5.7.md)
* [Connector/J 3.5.6 Release Notes](connectors/java/3.5/3.5.6.md)
* [Connector/J 3.5.5 Release Notes](connectors/java/3.5/3.5.5.md)
* [Connector/J 3.5.4 Release Notes](connectors/java/3.5/3.5.4.md)
Expand Down Expand Up @@ -2025,6 +2026,7 @@
* [Connector/J 3.0.1 Release Notes](connectors/java/3.0/3.0.1.md)
* [Connector/J 3.0.0 Release Notes](connectors/java/3.0/3.0.0.md)
* [Connector/J 2.7 Release Notes](connectors/java/2.7/README.md)
* [Connector/J 2.7.13 Release Notes](connectors/java/2.7/2.7.13.md)
* [Connector/J 2.7.12 Release Notes](connectors/java/2.7/2.7.12.md)
* [Connector/J 2.7.11 Release Notes](connectors/java/2.7/2.7.11.md)
* [Connector/J 2.7.10 Release Notes](connectors/java/2.7/2.7.10.md)
Expand Down
4 changes: 2 additions & 2 deletions release-notes/connectors/java/3.5/3.5.6.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,8 @@ MariaDB Connector/J 3.5.6 is a [_**Stable**_](../../../community-server/about/re

## Changelog

For a complete list of changes made in MariaDB Connector/J 3.5.5, with links to detailed\
information on each push, see the [changelog](../changelogs/3.5/3.5.5.md).
For a complete list of changes made in MariaDB Connector/J 3.5.6, with links to detailed\
information on each push, see the [changelog](../changelogs/3.5/3.5.6.md).

{% include "https://app.gitbook.com/s/SsmexDFPv2xG2OTyO5yV/~/reusable/pNHZQXPP5OEz2TgvhFva/" %}

Expand Down
37 changes: 37 additions & 0 deletions release-notes/connectors/java/3.5/3.5.7.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
---
hidden: true
---
# Connector/J 3.5.7 Release Notes

{% include "../../../.gitbook/includes/unreleased-java.md" %}

<a href="https://mariadb.com/downloads/connectors/connectors-data-access/java8-connector" class="button primary">Download</a> <a href="3.5.7.md" class="button secondary">Release Notes</a> <a href="../changelogs/3.5/3.5.7.md" class="button secondary">Changelog</a> <a href="https://app.gitbook.com/s/CjGYMsT2MVP4nd3IyW2L/mariadb-connector-j/about-mariadb-connector-j" class="button secondary">Connector/J Overview</a>

**Release date:** XX Dec 2025

MariaDB Connector/J 3.5.7 is a [_**Stable**_](../../../community-server/about/release-criteria.md) _**(GA)**_ release.

{% include "../../../.gitbook/includes/connector-j-overview.md" %}

## Notable changes

* [CONJ-1282](https://jira.mariadb.org/browse/CONJ-1282) Added TLS SNI (Server Name Indication) support
* [CONJ-1271](https://jira.mariadb.org/browse/CONJ-1271) Added MariaDbDataTruncation exception that includes MariaDB error code and error message

## Bugs Fixed

* [CONJ-1291](https://jira.mariadb.org/browse/CONJ-1291) Fixed ConnectionPoolDataSource incompatibility and connection leaks due to internal ConnectionEventListener in MariaDB Connector/J 3.5.x
* [CONJ-1286](https://jira.mariadb.org/browse/CONJ-1286) Fixed MariaDbPoolPinnedConnection thread-safety issue
* [CONJ-1283](https://jira.mariadb.org/browse/CONJ-1283) Fixed rewriteBatchedStatements introduced in 3.5.6 bug when having parenthesis after VALUES parts
* [CONJ-1287](https://jira.mariadb.org/browse/CONJ-1287) Fixed authentication plugin multi-exchange prefix (0x01) handling introduced in MDEV-37554
* [CONJ-1290](https://jira.mariadb.org/browse/CONJ-1290) Fixed NullPointerException in MultiPrimaryReplicaClient
* [CONJ-1295](https://jira.mariadb.org/browse/CONJ-1295) Fixed MariaDbClob compilation with JDK 26+

## Changelog

For a complete list of changes made in MariaDB Connector/J 3.5.7, with links to detailed\
information on each push, see the [changelog](../changelogs/3.5/3.5.7.md).

{% include "https://app.gitbook.com/s/SsmexDFPv2xG2OTyO5yV/~/reusable/pNHZQXPP5OEz2TgvhFva/" %}

{% @marketo/form formid="4316" formId="4316" %}
3 changes: 2 additions & 1 deletion release-notes/connectors/java/all-releases.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ description: A list of all MariaDB Connector/J releases
## 3.5

| Release | Release Date | Status | Min. Java Compat. |
| --------------------- | ------------ | ----------- | ----------------- |
|-----------------------|--------------| ----------- | ----------------- |
| [3.5.7](3.5/3.5.7.md) | XX Dec 2025 | Stable (GA) | Java 8 |
| [3.5.6](3.5/3.5.6.md) | 12 Aug 2025 | Stable (GA) | Java 8 |
| [3.5.5](3.5/3.5.5.md) | 08 Aug 2025 | Stable (GA) | Java 8 |
| [3.5.4](3.5/3.5.4.md) | 01 Jul 2025 | Stable (GA) | Java 8 |
Expand Down
42 changes: 42 additions & 0 deletions release-notes/connectors/java/changelogs/3.5/3.5.7.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
# Connector/J 3.5.7 Changelog

<a href="https://mariadb.com/downloads/connectors/connectors-data-access/java8-connector" class="button primary">Download</a> <a href="../../3.5/3.5.7.md" class="button secondary">Release Notes</a> <a href="3.5.7.md" class="button secondary">Changelog</a> <a href="https://app.gitbook.com/s/CjGYMsT2MVP4nd3IyW2L/mariadb-connector-j/about-mariadb-connector-j" class="button secondary">Connector/J Overview</a>

**Release date:** XX Dec 2025

For the highlights of this release, see the [release notes](../../3.5/3.5.7.md).

The revision number links will take you to the revision's page on GitHub. On [GitHub](https://github.com/MariaDB/mariadb-connector-j) you can view more\
details of the revision and view diffs of the code modified in that revision.

* [Revision #6d9179b2c](https://github.com/mariadb-corporation/mariadb-connector-j/commit/6d9179b2c) bump 3.5.7 version
* [Revision #46c3a4dbc](https://github.com/mariadb-corporation/mariadb-connector-j/commit/46c3a4dbc) \[[CONJ-1296](https://jira.mariadb.org/browse/CONJ-1296)] ResultSetMetaData.getSchemas() column labels might be returned in lowercase
* [Revision #5c9b41cce](https://github.com/mariadb-corporation/mariadb-connector-j/commit/5c9b41cce) \[[CONJ-1271](https://jira.mariadb.org/browse/CONJ-1271)] Add MariaDbDataTruncation class to properly handle data truncation exceptions
* [Revision #1b48cd01c](https://github.com/mariadb-corporation/mariadb-connector-j/commit/1b48cd01c) \[[CONJ-1283](https://jira.mariadb.org/browse/CONJ-1283)] fix INSERT rewrite detection when VALUES clause has trailing parenthesis after values clause
* [Revision #6c0fb7055](https://github.com/mariadb-corporation/mariadb-connector-j/commit/6c0fb7055) Merge branch 'fork/necposs/fix/conj-1286' into develop
* [Revision #efd77b12c](https://github.com/mariadb-corporation/mariadb-connector-j/commit/efd77b12c) \[[CONJ-1290](https://jira.mariadb.org/browse/CONJ-1290)] fix syncNewState to use previous client state when switching between primary and replica
* [Revision #0559d0237](https://github.com/mariadb-corporation/mariadb-connector-j/commit/0559d0237) \[[CONJ-1291](https://jira.mariadb.org/browse/CONJ-1291)] PooledConnection behavior clarification. PooledConnection itself must only be closed by pool and close underlying connection. PoolConnection connection must only release pooledConnection to pool.
* [Revision #995eecd8f](https://github.com/mariadb-corporation/mariadb-connector-j/commit/995eecd8f) \[[CONJ-1293](https://jira.mariadb.org/browse/CONJ-1293)] add unit test
* [Revision #52e5e20d6](https://github.com/mariadb-corporation/mariadb-connector-j/commit/52e5e20d6) [misc] micro optimization
* [Revision #ae3704d42](https://github.com/mariadb-corporation/mariadb-connector-j/commit/ae3704d42) [misc] code style correction: fix IPUtility
* [Revision #59d5c8da2](https://github.com/mariadb-corporation/mariadb-connector-j/commit/59d5c8da2) [misc] Ensure not sending clear password when using SSL not completely trusted
* [Revision #14c8911e3](https://github.com/mariadb-corporation/mariadb-connector-j/commit/14c8911e3) [misc] DatabaseMetaData: fix catalog order in schema query in case of catalog multiple value in the future
* [Revision #904ee8322](https://github.com/mariadb-corporation/mariadb-connector-j/commit/904ee8322) \[[CONJ-1282](https://jira.mariadb.org/browse/CONJ-1282)] SNI TLS support
* [Revision #3feaccbbd](https://github.com/mariadb-corporation/mariadb-connector-j/commit/3feaccbbd) \[[CONJ-1295](https://jira.mariadb.org/browse/CONJ-1295)] ensure having close implementation in BLOB for java 4.5 spec
* [Revision #7a9549178](https://github.com/mariadb-corporation/mariadb-connector-j/commit/7a9549178) [misc] correct java version checking for early access version
* [Revision #7e9ba6000](https://github.com/mariadb-corporation/mariadb-connector-j/commit/7e9ba6000) [misc] use bnd-maven-plugin compatible with java 11
* [Revision #f60ea65f8](https://github.com/mariadb-corporation/mariadb-connector-j/commit/f60ea65f8) [misc] bump dependencies version
* [Revision #d43fed077](https://github.com/mariadb-corporation/mariadb-connector-j/commit/d43fed077) Merge remote-tracking branch 'origin/dependabot/maven/org.bouncycastle-bcpkix-jdk18on-1.79' into develop
* [Revision #2c21f20a0](https://github.com/mariadb-corporation/mariadb-connector-j/commit/2c21f20a0) [misc] bump 3.5.7 SNAPSHOT version
* [Revision #4df11a0e1](https://github.com/mariadb-corporation/mariadb-connector-j/commit/4df11a0e1) [misc] micro performance improvement
* [Revision #40fba1068](https://github.com/mariadb-corporation/mariadb-connector-j/commit/40fba1068) \[[CONJ-1287](https://jira.mariadb.org/browse/CONJ-1287)] Handle authentication plugin multi-exchange prefix (0x01) introduced in MDEV-37554
* [Revision #7c63472e3](https://github.com/mariadb-corporation/mariadb-connector-j/commit/7c63472e3) \[[CONJ-1286](https://jira.mariadb.org/browse/CONJ-1286)] Make MariaDbPoolPinnedConnection.xidToConnection thread safe
* [Revision #431bfb1bf](https://github.com/mariadb-corporation/mariadb-connector-j/commit/431bfb1bf) Bump org.bouncycastle:bcpkix-jdk18on from 1.78.1 to 1.79
* [Revision #5222bfb7b](https://github.com/mariadb-corporation/mariadb-connector-j/commit/5222bfb7b) Merge branch 'develop'
* [Revision #078e90429](https://github.com/mariadb-corporation/mariadb-connector-j/commit/078e90429) [misc] test stability improvement
* [Revision #ecd7beca3](https://github.com/mariadb-corporation/mariadb-connector-j/commit/ecd7beca3) [misc] adding java 25 to test suite
* [Revision #995e7f789](https://github.com/mariadb-corporation/mariadb-connector-j/commit/995e7f789) [misc] test improvement

{% include "https://app.gitbook.com/s/SsmexDFPv2xG2OTyO5yV/~/reusable/pNHZQXPP5OEz2TgvhFva/" %}

{% @marketo/form formid="4316" formId="4316" %}