This is an automated email from the ASF dual-hosted git repository.
davidzollo pushed a commit to branch dev
in repository https://gitbox.apache.org/repos/asf/seatunnel.git
The following commit(s) were added to refs/heads/dev by this push:
new 01c0b21e99 [Docs][Jdbc] Clarify MariaDB driver configuration (#11604)
01c0b21e99 is described below
commit 01c0b21e9995eead937b869963d74443e8f2e786
Author: lifeng <[email protected]>
AuthorDate: Sun Aug 2 18:35:59 2026 +0800
[Docs][Jdbc] Clarify MariaDB driver configuration (#11604)
---
docs/en/connectors/sink/Jdbc.md | 13 +++++++++++++
docs/en/connectors/source/Jdbc.md | 13 +++++++++++++
docs/zh/connectors/sink/Jdbc.md | 13 +++++++++++++
docs/zh/connectors/source/Jdbc.md | 13 +++++++++++++
4 files changed, 52 insertions(+)
diff --git a/docs/en/connectors/sink/Jdbc.md b/docs/en/connectors/sink/Jdbc.md
index 3622c604ca..d3181e8a41 100644
--- a/docs/en/connectors/sink/Jdbc.md
+++ b/docs/en/connectors/sink/Jdbc.md
@@ -131,6 +131,19 @@ Expected rows:
If the job fails before writing, check [Troubleshooting](#troubleshooting)
first.
+:::note
+
+When connecting to MariaDB, use MariaDB Connector/J with the matching URL and
driver:
+
+```hocon
+url = "jdbc:mariadb://localhost:3306/database"
+driver = "org.mariadb.jdbc.Driver"
+```
+
+Do not use MySQL Connector/J with a `jdbc:mysql:` URL for MariaDB. That
configuration selects the MySQL dialect, which can reject a MariaDB server
version as an unsupported MySQL version.
+
+:::
+
## Key Features
- [x] [exactly-once](../../introduction/concepts/connector-v2-features.md)
diff --git a/docs/en/connectors/source/Jdbc.md
b/docs/en/connectors/source/Jdbc.md
index 1521a6d2ee..6c4335f510 100644
--- a/docs/en/connectors/source/Jdbc.md
+++ b/docs/en/connectors/source/Jdbc.md
@@ -120,6 +120,19 @@ cd "${SEATUNNEL_HOME}"
If the job fails before reading rows, check
[Troubleshooting](#troubleshooting) first.
+:::note
+
+When connecting to MariaDB, use MariaDB Connector/J with the matching URL and
driver:
+
+```hocon
+url = "jdbc:mariadb://localhost:3306/database"
+driver = "org.mariadb.jdbc.Driver"
+```
+
+Do not use MySQL Connector/J with a `jdbc:mysql:` URL for MariaDB. That
configuration selects the MySQL dialect, which can reject a MariaDB server
version as an unsupported MySQL version.
+
+:::
+
## Key features
- [x] [batch](../../introduction/concepts/connector-v2-features.md)
diff --git a/docs/zh/connectors/sink/Jdbc.md b/docs/zh/connectors/sink/Jdbc.md
index c486d61336..1db79f01f0 100644
--- a/docs/zh/connectors/sink/Jdbc.md
+++ b/docs/zh/connectors/sink/Jdbc.md
@@ -131,6 +131,19 @@ ORDER BY id;
如果任务在写入前失败，请先检查[故障排查](#故障排查)。
+:::note
+
+连接 MariaDB 时，请使用 MariaDB Connector/J 以及匹配的 URL 和驱动：
+
+```hocon
+url = "jdbc:mariadb://localhost:3306/database"
+driver = "org.mariadb.jdbc.Driver"
+```
+
+不要使用 MySQL Connector/J 和 `jdbc:mysql:` URL 连接 MariaDB。该配置会选择 MySQL 方言，可能将
MariaDB 服务端版本判定为不支持的 MySQL 版本。
+
+:::
+
## 主要特性
- [x] [精确一次](../../introduction/concepts/connector-v2-features.md)
diff --git a/docs/zh/connectors/source/Jdbc.md
b/docs/zh/connectors/source/Jdbc.md
index cb5d185789..621858b971 100644
--- a/docs/zh/connectors/source/Jdbc.md
+++ b/docs/zh/connectors/source/Jdbc.md
@@ -120,6 +120,19 @@ cd "${SEATUNNEL_HOME}"
如果任务在读取数据前失败，请先检查[故障排查](#故障排查)。
+:::note
+
+连接 MariaDB 时，请使用 MariaDB Connector/J 以及匹配的 URL 和驱动：
+
+```hocon
+url = "jdbc:mariadb://localhost:3306/database"
+driver = "org.mariadb.jdbc.Driver"
+```
+
+不要使用 MySQL Connector/J 和 `jdbc:mysql:` URL 连接 MariaDB。该配置会选择 MySQL 方言，可能将
MariaDB 服务端版本判定为不支持的 MySQL 版本。
+
+:::
+
## 关键特性
- [x] [批](../../introduction/concepts/connector-v2-features.md)
