Skip to content

Commit 510bf30

Browse files
committed
docs(kernel): clarify max connections version
Signed-off-by: Vu Anh Phung <vu.phung@databricks.com>
1 parent be59b7e commit 510bf30

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

CONNECTION_PARAMETERS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ to change without notice.
102102
| ------------------------------------ | ----------- | :----: | :----: | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
103103
| `_socket_timeout` | `float` (s) ||| `900` (Thrift); `120` (kernel) | Thrift: socket send/recv/connect timeout. Kernel: total HTTP request deadline from connect through response-body completion. A positive value is forwarded; unset or `0` selects the kernel's 120s default. On the kernel path, `0` is neither unlimited nor an immediate timeout. |
104104
| `_pool_connections` | `int` || ⚠️ | `10` | Number of urllib3 connection pools. Configures the connector's shared Python HTTP client; the kernel's query transport is its own Rust stack. |
105-
| `_pool_maxsize` | `int` || | `20` (Thrift); `100` (kernel when unset) | Max idle connections retained per host. An explicit value configures both the shared Python HTTP client and the kernel's Rust HTTP pool. |
105+
| `_pool_maxsize` | `int` || ⚠️ | `20` (Thrift); `100` (kernel when unset) | Max idle connections retained per host. An explicit value always configures the shared Python HTTP client and also configures the kernel's Rust HTTP pool with kernel ≥ 1.1.0. |
106106
| `_proxy_auth_method` | `str` || ⚠️ | `None` | `basic` or `negotiate` (Kerberos). Applies to the shared Python HTTP client; not threaded to the kernel query transport. See [`docs/proxy.md`](docs/proxy.md). |
107107
| `_retry_stop_after_attempts_count` | `int` ||| `30` | Max attempts in a retry sequence. Bounded to `[1, 60]` on Thrift; forwarded to the kernel's retry policy. |
108108
| `_retry_stop_after_attempts_duration`| `float` (s) ||| `900` | Max total wall-clock seconds spent retrying. Forwarded to the kernel. |
@@ -204,7 +204,7 @@ None — the kernel's parameter surface is currently a subset of Thrift's.
204204

205205
- **Connection pooling / proxy**: `_pool_connections` and `_proxy_auth_method`
206206
configure only the shared Python HTTP client. `_pool_maxsize` also configures
207-
the kernel's Rust HTTP pool when explicitly set.
207+
the kernel's Rust HTTP pool when explicitly set and using kernel ≥ 1.1.0.
208208
- **`use_inline_params`** renders parameters inline on Thrift; the kernel uses
209209
native parameter binding.
210210

0 commit comments

Comments
 (0)