Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
336 changes: 0 additions & 336 deletions docs/integrations/language-clients/java/client/_snippets/_v0_7.mdx

This file was deleted.

783 changes: 0 additions & 783 deletions docs/integrations/language-clients/java/client/_snippets/_v0_8.mdx

This file was deleted.

1,400 changes: 1,393 additions & 7 deletions docs/integrations/language-clients/java/client/client.mdx

Large diffs are not rendered by default.

11 changes: 7 additions & 4 deletions docs/integrations/language-clients/java/index.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: 'Java'
sidebar_position: 1
keywords: ['clickhouse', 'java', 'jdbc', 'client', 'integrate', 'r2dbc']
description: 'Options for connecting to ClickHouse from Java'
slug: /integrations/java
Expand All @@ -20,7 +21,7 @@

Java client is a library implementing own API that abstracts details of network communications with ClickHouse server. Currently HTTP Interface is supported only. The library provide utilities to work with different ClickHouse formats and other related functions.

Java Client was developed far back in 2015. Its codebase became very hard to maintain, API is confusing, it is hard to optimize it further. So we have refactored it in 2024 into a new component `client-v2`. It has clear API, lighter codebase and more performance improvements, better ClickHouse formats support (RowBinary & Native mainly). JDBC will use this client in near feature.
Java Client was developed far back in 2015. Its codebase became very hard to maintain, API is confusing, it is hard to optimize it further. So we have refactored it in 2024 into a new component `client-v2`. It has clear API, lighter codebase and more performance improvements, better ClickHouse formats support (RowBinary & Native mainly). JDBC will use this client in near feature.

Check notice on line 24 in docs/integrations/language-clients/java/index.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.Uppercase

Suggestion: Instead of uppercase for 'JDBC', use lowercase or backticks (`) if possible. Otherwise, ask a Technical Writer to add this word or acronym to the rule's exception list.

Check notice on line 24 in docs/integrations/language-clients/java/index.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.Contractions

Suggestion: Use 'we've' instead of 'we have'.

Check notice on line 24 in docs/integrations/language-clients/java/index.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.Contractions

Suggestion: Use 'it's' instead of 'it is'.

### Supported data types {#supported-data-types}

Expand Down Expand Up @@ -83,7 +84,7 @@
- AggregatedFunction - :warning: does not support `SELECT * FROM table ...`
- Decimal - `SET output_format_decimal_trailing_zeros=1` in 21.9+ for consistency
- Enum - can be treated as both string and integer
- UInt64 - mapped to `long` in client-v1
- UInt64 - mapped to `long` in client-v1
:::

### Features {#features}
Expand All @@ -94,7 +95,8 @@
|----------------------------------------------|:---------:|:---------:|:---------:|
| Http Connection |✔ |✔ | |
| Http Compression (LZ4) |✔ |✔ | |
| Server Response Compression - LZ4 |✔ |✔ | |
| Application Controlled Compression |✔ |✗ | |
| Server Response Compression - LZ4 |✔ |✔ | |
| Client Request Compression - LZ4 |✔ |✔ | |
| HTTPS |✔ |✔ | |
| Client SSL Cert (mTLS) |✔ |✔ | |
Expand All @@ -109,6 +111,7 @@
| Log Comment |✔ |✔ | |
| Session Roles |✔ |✔ | |
| SSL Client Authentication |✔ |✔ | |
| SNI Configuration |✔ |✗ | |

Check notice on line 114 in docs/integrations/language-clients/java/index.md

View workflow job for this annotation

GitHub Actions / vale

ClickHouse.Uppercase

Suggestion: Instead of uppercase for 'SNI', use lowercase or backticks (`) if possible. Otherwise, ask a Technical Writer to add this word or acronym to the rule's exception list.
| Session timezone |✔ |✔ | |

JDBC Drive inherits same features as underlying client implementation. Other JDBC features are listed on its [page](/integrations/language-clients/java/jdbc).
Expand All @@ -122,7 +125,7 @@

### Logging {#logging}

Our Java language client uses [SLF4J](https://www.slf4j.org/) for logging. You can use any SLF4J-compatible logging framework, such as `Logback` or `Log4j`.
Our Java language client uses [SLF4J](https://www.slf4j.org/) for logging. You can use any SLF4J-compatible logging framework, such as `Logback` or `Log4j`.
For example, if you are using Maven you could add the following dependency to your `pom.xml` file:

```xml title="pom.xml"
Expand Down
387 changes: 0 additions & 387 deletions docs/integrations/language-clients/java/jdbc/_snippets/_v0_7.mdx

This file was deleted.

225 changes: 0 additions & 225 deletions docs/integrations/language-clients/java/jdbc/_snippets/_v0_8.mdx

This file was deleted.

Loading