Skip to content

[Java] update JDBC docs. #6416

Merged
chernser merged 2 commits into
mainfrom
06/17/26/describe_reading_json
Jun 18, 2026
Merged

[Java] update JDBC docs. #6416
chernser merged 2 commits into
mainfrom
06/17/26/describe_reading_json

Conversation

@chernser

@chernser chernser commented Jun 18, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds note about usage of readonly profiles
  • Adds description how to read JSON values in JDBC

Closes: ClickHouse/clickhouse-java#2760

Checklist


Note

Low Risk
Documentation-only changes with no runtime or API impact.

Overview
Documentation-only updates to the Java JDBC integration guide (jdbc.mdx).

Adds a Readonly Profiles note under connection configuration: the driver intentionally omits default connection settings to stay compatible with read-only profiles, and recommends readonly=2 when users need format-related server settings (e.g. reading JSON as a string), with a link to the constraints-on-settings docs.

Adds a JSON Type section under special types: default Map<String, Object> mapping with a nested example, optional string reads via connection/server settings (jdbc_read_json_as_string / OUTPUT_FORMAT_BINARY_WRITE_JSON_AS_STRING), and guidance on JSON number quoting for ClickHouse 25.8+ vs older servers via output_format_json_quote_* server settings.

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

@chernser chernser requested review from a team as code owners June 18, 2026 05:44
@vercel

vercel Bot commented Jun 18, 2026

Copy link
Copy Markdown

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

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

Request Review

@chernser

Copy link
Copy Markdown
Contributor Author

Help needed to understand validation failures.
Thanks!

@chernser chernser merged commit 900f85b into main Jun 18, 2026
18 checks passed
@chernser chernser deleted the 06/17/26/describe_reading_json branch June 18, 2026 15:59
@mintlify

mintlify Bot commented Jun 18, 2026

Copy link
Copy Markdown

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

Added Readonly Profiles note and JSON Type section to the Java JDBC integration docs, ported from upstream PR #6416.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[jdbc-v2] Reading JSON as String

3 participants