From 4ecfb201e5a76d09e0e6a3dcda117c7b981a8b55 Mon Sep 17 00:00:00 2001 From: Sergey Chernov Date: Thu, 31 Jul 2025 10:33:19 -0700 Subject: [PATCH] Upated version and documentation for new config params --- .../java/client/_snippets/_v0_8.mdx | 13 +++++++++---- .../language-clients/java/jdbc/_snippets/_v0_8.mdx | 8 +++++--- 2 files changed, 14 insertions(+), 7 deletions(-) diff --git a/docs/integrations/language-clients/java/client/_snippets/_v0_8.mdx b/docs/integrations/language-clients/java/client/_snippets/_v0_8.mdx index 337aa82f4b4..e22e1f07914 100644 --- a/docs/integrations/language-clients/java/client/_snippets/_v0_8.mdx +++ b/docs/integrations/language-clients/java/client/_snippets/_v0_8.mdx @@ -8,7 +8,8 @@ The library provides its own API to send requests to a server. The library also ## Setup {#setup} - Maven Central (project web page): https://mvnrepository.com/artifact/com.clickhouse/client-v2 -- Nightly builds (repository link): https://s01.oss.sonatype.org/content/repositories/snapshots/com/clickhouse/ +- Nightly builds (repository link): https://central.sonatype.com/repository/maven-snapshots/ +- Old Nightly builds artifactory (repository link): https://s01.oss.sonatype.org/content/repositories/snapshots/
@@ -17,7 +18,7 @@ The library provides its own API to send requests to a server. The library also com.clickhouse client-v2 - 0.9.0 + 0.9.1 ``` @@ -26,14 +27,14 @@ The library provides its own API to send requests to a server. The library also ```kotlin // https://mvnrepository.com/artifact/com.clickhouse/client-v2 -implementation("com.clickhouse:client-v2:0.9.0") +implementation("com.clickhouse:client-v2:0.9.1") ``` ```groovy // https://mvnrepository.com/artifact/com.clickhouse/client-v2 -implementation 'com.clickhouse:client-v2:0.9.0' +implementation 'com.clickhouse:client-v2:0.9.1' ``` @@ -162,6 +163,10 @@ Configuration is defined during client creation. See `com.clickhouse.client.api. | `useHTTPBasicAuth(boolean useBasicAuth)` | - `useBasicAuth` - flag that indicates if the option should be enabled | Sets if basic HTTP authentication should be used for user-password authentication. Default is enabled. Using this type of authentication resolves issues with passwords containing special characters that cannot be transferred over HTTP headers.

Default: `true`
Enum: `ClientConfigProperties.HTTP_USE_BASIC_AUTH`
Key: `http_use_basic_auth` | | `setClientName(String clientName)` | - `clientName` - a string representing application name | Sets additional information about calling application. This string will be passed to server as a client name. In case of HTTP protocol it will be passed as a `User-Agent` header.

Default: -
Enum: `ClientConfigProperties.CLIENT_NAME`
Key: `client_name`| | `useBearerTokenAuth(String bearerToken)` | - `bearerToken` - an encoded bearer token | Specifies whether to use Bearer Authentication and what token to use. The token will be sent as is, so it should be encoded before passing to this method.

Default: -
Enum: `ClientConfigProperties.BEARERTOKEN_AUTH`
Key: `bearer_token` | +| `registerClientMetrics(Object registry, String name)` | - `registry` - Micrometer registry instance
- `name` - metrics group name | Registers sensors with Micrometer (https://micrometer.io/) registry instance. | +| `setServerVersion(String version)` | - `version` - string value of a server version | Sets server version to avoid version detection.

Default: -
Enum: `ClientConfigProperties.SERVER_VERSION`
Key: `server_version` | +| `typeHintMapping(Map typeHintMapping)` | - `typeHintMapping` - map of type hints | Sets type hint mapping for ClickHouse types. For example, to make multidimesional arrays be present as Java containers instead of own Array objects.

Default: -
Enum: `ClientConfigProperties.TYPE_HINT_MAPPING`
Key: `type_hint_mapping` | +| `sslSocketSNI(String sni)` | - `sni` - string value of a server name | Sets server name to be used for SNI (Server Name Indication) in SSL/TLS connection.

Default: -
Enum: `ClientConfigProperties.SSL_SOCKET_SNI`
Key: `ssl_socket_sni` | ### Server Settings diff --git a/docs/integrations/language-clients/java/jdbc/_snippets/_v0_8.mdx b/docs/integrations/language-clients/java/jdbc/_snippets/_v0_8.mdx index 04664d00a2a..40d0084a125 100644 --- a/docs/integrations/language-clients/java/jdbc/_snippets/_v0_8.mdx +++ b/docs/integrations/language-clients/java/jdbc/_snippets/_v0_8.mdx @@ -35,7 +35,7 @@ In 0.8 we tried to make the driver more strictly follow the JDBC specification, com.clickhouse clickhouse-jdbc - 0.8.2 + 0.9.1 shaded-all ``` @@ -45,14 +45,14 @@ In 0.8 we tried to make the driver more strictly follow the JDBC specification, ```kotlin // https://mvnrepository.com/artifact/com.clickhouse/clickhouse-jdbc - implementation("com.clickhouse:clickhouse-jdbc:0.8.2:shaded-all") + implementation("com.clickhouse:clickhouse-jdbc:0.9.1:shaded-all") ``` ```groovy // https://mvnrepository.com/artifact/com.clickhouse/clickhouse-jdbc - implementation 'com.clickhouse:clickhouse-jdbc:0.8.2:shaded-all' + implementation 'com.clickhouse:clickhouse-jdbc:0.9.1:shaded-all' ``` @@ -78,6 +78,8 @@ Where possible methods will return an `SQLFeatureNotSupportedException` if the f | `jdbc_ignore_unsupported_values` | `false` | Suppresses `SQLFeatureNotSupportedException` | | `clickhouse.jdbc.v1` | `false` | Use older JDBC implementation instead of new JDBC | | `default_query_settings` | `null` | Allows passing of default query settings with query operations | +| `jdbc_resultset_auto_close` | `true` | Automatically closes `ResultSet` when `Statement` is closed | +| `beta.row_binary_for_simple_insert` | `false` | Use `PreparedStatement` implementation based on `RowBinary` writer. Works only for `INSERT INTO ... VALUES` queries. | ## Supported data types {#supported-data-types}