Skip to content

[Integration Spec] Update docs/integration-jdbc.md - #3103

Draft
chernser wants to merge 1 commit into
mainfrom
09/06/26/int_spec_jdbc_changes
Draft

[Integration Spec] Update docs/integration-jdbc.md#3103
chernser wants to merge 1 commit into
mainfrom
09/06/26/int_spec_jdbc_changes

Conversation

@chernser

@chernser chernser commented Sep 6, 2026

Copy link
Copy Markdown
Contributor

Summary

Followup PR for comments.

https://github.com/ClickHouse/clickhouse-java/pull/2914/changes#r3594185661

Lets add step 8 in with:

    Docker setup for local clickhouse
    cloud environment - partners get credits to use
    reference to example test suites in our repo

we should make sure to highlight areas like:

    functional correctness: row count matches, data types, schema mismatch handling
    potential failure paths: idempotent inserts, retryable vs non-retryable, long operation failures
    latency vs throughput vs part count
    client_name, logging enabled
    cloud readiness: idle instance handling, long running query failures
    automated testing against the different channels in CH cloud for version support

Docker setup and cloud environment - added as "Development environment" section.
References to example test suites will be in another document. Currently we have many examples inline.

functional correctness - covered in Failure handling in Select and Insert operations
potential failure paths
- idempotent inserts - covered in "Idempotency — deduplication token"
- what is retryable - covered in failure handling section for each operation
- long operations failures

client_name - covered in "Workload identification" section

Checklist

Delete items not relevant to your PR:

  • Closes #
  • Unit and integration tests covering the common scenarios were added
  • A human-readable description of the changes was provided to include in CHANGELOG
  • For significant changes, documentation in https://github.com/ClickHouse/clickhouse-docs was updated with further explanations or tutorials

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.

1 participant