From 6b3b70465e433b18ab1d2abebc1682df3701cef2 Mon Sep 17 00:00:00 2001 From: sheyanjie Date: Fri, 15 May 2026 20:22:09 +0800 Subject: [PATCH 1/4] docs(jdbc): add adapter ha support --- docs/en/14-reference/05-connector/14-java.md | 1 + docs/zh/14-reference/05-connector/14-java.mdx | 1 + 2 files changed, 2 insertions(+) diff --git a/docs/en/14-reference/05-connector/14-java.md b/docs/en/14-reference/05-connector/14-java.md index 8475e8c26484..16966d1a3f7c 100644 --- a/docs/en/14-reference/05-connector/14-java.md +++ b/docs/en/14-reference/05-connector/14-java.md @@ -296,6 +296,7 @@ The configuration parameters in properties are as follows: > **Note**: Enabling auto-reconnect is not effective for fetching result sets. Auto-reconnect is only effective for connections established through parameters specifying the database, and ineffective for later `use db` statements to switch databases. - TSDBDriver.PROPERTY_KEY_RECONNECT_INTERVAL_MS [`reconnectIntervalMs`]: Auto-reconnect retry interval, in milliseconds, default value 2000. Effective only when PROPERTY_KEY_ENABLE_AUTO_RECONNECT is true. - TSDBDriver.PROPERTY_KEY_RECONNECT_RETRY_COUNT [`reconnectRetryCount`]: Auto-reconnect retry count, default value 3, effective only when PROPERTY_KEY_ENABLE_AUTO_RECONNECT is true. +- TSDBDriver.PROPERTY_KEY_ADAPTER_HA [`adapterHA`]: Whether to enable adapter high availability. Only takes effect when using WebSocket connections. true: enabled, false: disabled. Default is false. When enabled, upon successful connection, the client can obtain the list of all endpoints of adapter in the cluster for load balancing. This feature requires TDengine version `3.4.2.0` or higher. --- diff --git a/docs/zh/14-reference/05-connector/14-java.mdx b/docs/zh/14-reference/05-connector/14-java.mdx index 1699a7f9f18c..5c652762e766 100644 --- a/docs/zh/14-reference/05-connector/14-java.mdx +++ b/docs/zh/14-reference/05-connector/14-java.mdx @@ -298,6 +298,7 @@ properties 中的配置参数如下： > **注意**：启用自动重连对获取结果集无效。自动重连仅对连接建立时通过参数指定数据库有效，对后面的 `use db` 语句切换数据库无效。 - TSDBDriver.PROPERTY_KEY_RECONNECT_INTERVAL_MS [`reconnectIntervalMs`]：自动重连重试间隔，单位毫秒，默认值 2000。仅在 PROPERTY_KEY_ENABLE_AUTO_RECONNECT 为 true 时生效。 - TSDBDriver.PROPERTY_KEY_RECONNECT_RETRY_COUNT [`reconnectRetryCount`]：自动重连重试次数，默认值 3，仅在 PROPERTY_KEY_ENABLE_AUTO_RECONNECT 为 true 时生效。 +- TSDBDriver.PROPERTY_KEY_ADAPTER_HA [`adapterHA`]：是否启用 `adapter` 高可用。仅在使用 WebSocket 连接时生效。true：启用，false：不启用。默认为 false。启用后连接成功就能获取集群所有 `adapter` 列表用于负载均衡，需要 TDengine 版本大于等于 `3.4.2.0` 才能支持此特性。 --- From 698d29c3511e33b308e298daef126f36a1dcc0a4 Mon Sep 17 00:00:00 2001 From: She Yanjie <57549981+sheyanjie-qq@users.noreply.github.com> Date: Fri, 15 May 2026 20:25:55 +0800 Subject: [PATCH 2/4] Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> --- docs/en/14-reference/05-connector/14-java.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/14-reference/05-connector/14-java.md b/docs/en/14-reference/05-connector/14-java.md index 16966d1a3f7c..a708e1e5a9e6 100644 --- a/docs/en/14-reference/05-connector/14-java.md +++ b/docs/en/14-reference/05-connector/14-java.md @@ -296,7 +296,7 @@ The configuration parameters in properties are as follows: > **Note**: Enabling auto-reconnect is not effective for fetching result sets. Auto-reconnect is only effective for connections established through parameters specifying the database, and ineffective for later `use db` statements to switch databases. - TSDBDriver.PROPERTY_KEY_RECONNECT_INTERVAL_MS [`reconnectIntervalMs`]: Auto-reconnect retry interval, in milliseconds, default value 2000. Effective only when PROPERTY_KEY_ENABLE_AUTO_RECONNECT is true. - TSDBDriver.PROPERTY_KEY_RECONNECT_RETRY_COUNT [`reconnectRetryCount`]: Auto-reconnect retry count, default value 3, effective only when PROPERTY_KEY_ENABLE_AUTO_RECONNECT is true. -- TSDBDriver.PROPERTY_KEY_ADAPTER_HA [`adapterHA`]: Whether to enable adapter high availability. Only takes effect when using WebSocket connections. true: enabled, false: disabled. Default is false. When enabled, upon successful connection, the client can obtain the list of all endpoints of adapter in the cluster for load balancing. This feature requires TDengine version `3.4.2.0` or higher. +- TSDBDriver.PROPERTY_KEY_ADAPTER_HA [`adapterHA`]: Whether to enable adapter high availability. Only takes effect when using WebSocket connections. true: enabled, false: disabled. Default is false. When enabled, upon successful connection, the client can obtain the list of all adapter endpoints in the cluster for load balancing. This feature requires TDengine version `3.4.2.0` or higher. --- From a272d0a6c863d30cc99c88156383c7533ec057a6 Mon Sep 17 00:00:00 2001 From: She Yanjie <57549981+sheyanjie-qq@users.noreply.github.com> Date: Fri, 15 May 2026 20:31:36 +0800 Subject: [PATCH 3/4] Update docs/en/14-reference/05-connector/14-java.md Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com> --- docs/en/14-reference/05-connector/14-java.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/en/14-reference/05-connector/14-java.md b/docs/en/14-reference/05-connector/14-java.md index a708e1e5a9e6..582cdf642ab8 100644 --- a/docs/en/14-reference/05-connector/14-java.md +++ b/docs/en/14-reference/05-connector/14-java.md @@ -296,7 +296,7 @@ The configuration parameters in properties are as follows: > **Note**: Enabling auto-reconnect is not effective for fetching result sets. Auto-reconnect is only effective for connections established through parameters specifying the database, and ineffective for later `use db` statements to switch databases. - TSDBDriver.PROPERTY_KEY_RECONNECT_INTERVAL_MS [`reconnectIntervalMs`]: Auto-reconnect retry interval, in milliseconds, default value 2000. Effective only when PROPERTY_KEY_ENABLE_AUTO_RECONNECT is true. - TSDBDriver.PROPERTY_KEY_RECONNECT_RETRY_COUNT [`reconnectRetryCount`]: Auto-reconnect retry count, default value 3, effective only when PROPERTY_KEY_ENABLE_AUTO_RECONNECT is true. -- TSDBDriver.PROPERTY_KEY_ADAPTER_HA [`adapterHA`]: Whether to enable adapter high availability. Only takes effect when using WebSocket connections. true: enabled, false: disabled. Default is false. When enabled, upon successful connection, the client can obtain the list of all adapter endpoints in the cluster for load balancing. This feature requires TDengine version `3.4.2.0` or higher. +- TSDBDriver.PROPERTY_KEY_ADAPTER_HA [`adapterHA`]: Whether to enable adapter high availability. Only takes effect when using WebSocket connections. true: enabled, false: not enabled. Default is false. When enabled, upon successful connection, the client can obtain the list of all adapter endpoints in the cluster for load balancing. This feature requires TDengine version `3.4.2.0` or higher. --- From ef9c98cd519d62a2b120ba2ad2508192b6589155 Mon Sep 17 00:00:00 2001 From: sheyanjie Date: Fri, 15 May 2026 20:34:00 +0800 Subject: [PATCH 4/4] chore: improve some jdbc doc desc --- docs/zh/14-reference/05-connector/14-java.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/zh/14-reference/05-connector/14-java.mdx b/docs/zh/14-reference/05-connector/14-java.mdx index 5c652762e766..8c473b74801e 100644 --- a/docs/zh/14-reference/05-connector/14-java.mdx +++ b/docs/zh/14-reference/05-connector/14-java.mdx @@ -298,7 +298,7 @@ properties 中的配置参数如下： > **注意**：启用自动重连对获取结果集无效。自动重连仅对连接建立时通过参数指定数据库有效，对后面的 `use db` 语句切换数据库无效。 - TSDBDriver.PROPERTY_KEY_RECONNECT_INTERVAL_MS [`reconnectIntervalMs`]：自动重连重试间隔，单位毫秒，默认值 2000。仅在 PROPERTY_KEY_ENABLE_AUTO_RECONNECT 为 true 时生效。 - TSDBDriver.PROPERTY_KEY_RECONNECT_RETRY_COUNT [`reconnectRetryCount`]：自动重连重试次数，默认值 3，仅在 PROPERTY_KEY_ENABLE_AUTO_RECONNECT 为 true 时生效。 -- TSDBDriver.PROPERTY_KEY_ADAPTER_HA [`adapterHA`]：是否启用 `adapter` 高可用。仅在使用 WebSocket 连接时生效。true：启用，false：不启用。默认为 false。启用后连接成功就能获取集群所有 `adapter` 列表用于负载均衡，需要 TDengine 版本大于等于 `3.4.2.0` 才能支持此特性。 +- TSDBDriver.PROPERTY_KEY_ADAPTER_HA [`adapterHA`]：是否启用 `adapter` 高可用。仅在使用 WebSocket 连接时生效。true：启用，false：不启用。默认为 false。启用后连接成功即可获取集群所有 `adapter` 端点列表用于负载均衡，需要 TDengine 版本大于等于 `3.4.2.0` 才能支持此特性。 ---