Skip to content

[JAVA] Update JDBC docs#6297

Merged
chernser merged 3 commits into
mainfrom
05/27/26/java_update_jdbc_mapping
Jun 1, 2026
Merged

[JAVA] Update JDBC docs#6297
chernser merged 3 commits into
mainfrom
05/27/26/java_update_jdbc_mapping

Conversation

@chernser
Copy link
Copy Markdown
Contributor

@chernser chernser commented May 28, 2026

Summary

  • Updates type mapping for V2
  • Adds explanation of V2 array base type mapping
  • Updates migration difference.

Closes: ClickHouse/clickhouse-java#2746
Closes: ClickHouse/clickhouse-java#2606

Checklist


Note

Low Risk
Documentation-only changes to the Java JDBC integration page; no runtime or security impact.

Overview
Updates the JDBC V2 documentation in jdbc.mdx so type mapping tables match current driver behavior and migration notes stay accurate.

Type mapping — Replaces many OTHER JDBC codes with standard types (e.g. wide integers and unsigned types → NUMERIC / sized integers, Float32FLOAT, enums → VARCHAR, MapOTHER instead of JAVA_OBJECT). The V1 vs V2 migration tables for numerics and DateTime / DateTime64 are aligned with those codes (including V1 DateTime as TIMESTAMP_WITH_TIMEZONE).

Arrays — Adds an Array Element Type Metadata section describing Array.getBaseTypeName() / getBaseType(), V2 vs V1 signature preservation, nested-array flattening, and example rows for common element types.

Reviewed by Cursor Bugbot for commit 700bfb3. Bugbot is set up for automated code reviews on this repo. Configure here.

@chernser chernser requested review from a team as code owners May 28, 2026 00:25
@vercel
Copy link
Copy Markdown

vercel Bot commented May 28, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
clickhouse-docs Ready Ready Preview, Comment Jun 1, 2026 4:23pm
4 Skipped Deployments
Project Deployment Actions Updated (UTC)
clickhouse-docs-jp Ignored Ignored Jun 1, 2026 4:23pm
clickhouse-docs-ko Ignored Ignored Preview Jun 1, 2026 4:23pm
clickhouse-docs-ru Ignored Ignored Preview Jun 1, 2026 4:23pm
clickhouse-docs-zh Ignored Ignored Preview Jun 1, 2026 4:23pm

Request Review

@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 28, 2026

Docs PR opened: ClickHouse/mintlify-docs-dev#89

Updated the Java JDBC docs with V2 type codes, revised type mappings, and a new Array element metadata section.

Once this PR is merged, we'll do a second pass to capture any additional changes and update the docs PR.

Comment thread docs/integrations/language-clients/java/jdbc/jdbc.mdx Outdated
Comment thread docs/integrations/language-clients/java/jdbc/jdbc.mdx Outdated
@chernser chernser merged commit f0ee6c8 into main Jun 1, 2026
18 checks passed
@chernser chernser deleted the 05/27/26/java_update_jdbc_mapping branch June 1, 2026 16:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

3 participants