This is an automated email from the ASF dual-hosted git repository.
yuqi4733 pushed a commit to branch branch-1.2
in repository https://gitbox.apache.org/repos/asf/gravitino.git
The following commit(s) were added to refs/heads/branch-1.2 by this push:
new cd2db8a646 [Cherry-pick to branch-1.2] [#10308] docs(clickhouse):
clarify verified JDBC compatibility matrix (#10463) (#10491)
cd2db8a646 is described below
commit cd2db8a64685835e193dc012aa1b0389f5c2c46f
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Fri Mar 20 21:54:03 2026 +0800
[Cherry-pick to branch-1.2] [#10308] docs(clickhouse): clarify verified
JDBC compatibility matrix (#10463) (#10491)
**Cherry-pick Information:**
- Original commit: 9377ca23b6e14996926cbb4fdb6fd4623ec425dc
- Target branch: `branch-1.2`
- Status: ✅ Clean cherry-pick (no conflicts)
Co-authored-by: Qi Yu <[email protected]>
Co-authored-by: Copilot <[email protected]>
---
docs/jdbc-clickhouse-catalog.md | 11 +++++++++--
1 file changed, 9 insertions(+), 2 deletions(-)
diff --git a/docs/jdbc-clickhouse-catalog.md b/docs/jdbc-clickhouse-catalog.md
index 7be0533219..6a6ed463fd 100644
--- a/docs/jdbc-clickhouse-catalog.md
+++ b/docs/jdbc-clickhouse-catalog.md
@@ -31,8 +31,15 @@ ClickHouse catalog is not included in the standard Gravitino
server distribution
| Drivers | Requires user-provided ClickHouse JDBC driver in
`${GRAVITINO_HOME}/catalogs/jdbc-clickhouse/libs`, please download the jar from
[link](https://repo1.maven.org/maven2/com/clickhouse/clickhouse-jdbc/0.7.1/) |
| Supported version | All the codes are tested by ClickHouse `24.8.14`, newer
versions like `25.x` may also work but we did not conduct thorough tests.
Report to the community if something does not work as expected. |
-:::note
-ClickHouse Driver 0.7.1 is recommended for better compatibility. Some older
versions of the ClickHouse JDBC driver have issues such as incorrect metadata
reporting that may cause problems with Gravitino's metadata management. If you
encounter issues, please check the driver version and consider upgrading to
0.7.1 or later. If the problem still persists, please report it to the
Gravitino community for further investigation.
+### ClickHouse server and JDBC driver compatibility matrix
+
+| ClickHouse version | Supported ClickHouse JDBC driver versions |
+|--------------------------------|-------------------------------------------|
+| `24.8.x` (including `24.8.14`) | `0.7.1 ~ 0.8.4` |
+
+:::tip
+For other ClickHouse versions (not 24.8.x), the required JDBC driver version
may be different.
+Use your staging validation results and the official ClickHouse documentation
as the final reference.
:::
### Catalog properties
