|
2 | 2 |
|
3 | 3 | Golang SQL database client for [ClickHouse](https://clickhouse.com/).
|
4 | 4 |
|
5 |
| -## Versions |
6 |
| - |
7 |
| -There are two version of this client, v1 and v2, available as separate branches. |
8 |
| - |
9 |
| -**v1 is now in a state of a maintenance - we will only accept PRs for bug and security fixes.** |
10 |
| - |
11 |
| -Users should use v2 which is production ready and [significantly faster than v1](#benchmark). |
12 |
| - |
13 |
| -v2 has breaking changes for users migrating from v1. These were not properly tracked prior to this client being officially supported. We endeavour to track known differences [here](https://github.com/ClickHouse/clickhouse-go/blob/main/v1_v2_CHANGES.md) and resolve where possible. |
14 |
| - |
15 |
| -## Supported ClickHouse Versions |
16 |
| - |
17 |
| -The client is tested against the currently [supported versions](https://github.com/ClickHouse/ClickHouse/blob/master/SECURITY.md) of ClickHouse |
18 |
| - |
19 |
| -## Supported Golang Versions |
20 |
| - |
21 |
| -| Client Version | Golang Versions | |
22 |
| -|----------------|-----------------| |
23 |
| -| => 2.0 <= 2.2 | 1.17, 1.18 | |
24 |
| -| >= 2.3 | 1.18.4+, 1.19 | |
25 |
| -| >= 2.14 | 1.20, 1.21 | |
26 |
| - |
27 | 5 | ## Key features
|
28 | 6 |
|
29 | 7 | * Uses ClickHouse native format for optimal performance. Utilises low level [ch-go](https://github.com/ClickHouse/ch-go) client for encoding/decoding and compression (versions >= 2.3.0).
|
@@ -55,6 +33,21 @@ Support for the ClickHouse protocol advanced features using `Context`:
|
55 | 33 | * Profile info
|
56 | 34 | * Profile events
|
57 | 35 |
|
| 36 | + |
| 37 | +## Supported ClickHouse Versions |
| 38 | + |
| 39 | +The client is tested against the currently [supported versions](https://github.com/ClickHouse/ClickHouse/blob/master/SECURITY.md) of ClickHouse |
| 40 | + |
| 41 | +## Supported Golang Versions |
| 42 | + |
| 43 | +| Client Version | Golang Versions | |
| 44 | +|----------------|-----------------| |
| 45 | +| => 2.0 <= 2.2 | 1.17, 1.18 | |
| 46 | +| >= 2.3 | 1.18.4+, 1.19 | |
| 47 | +| >= 2.14 | 1.20, 1.21 | |
| 48 | +| >= 2.19 | 1.21, 1.22 | |
| 49 | +| >= 2.28 | 1.22, 1.23 | |
| 50 | + |
58 | 51 | ## Documentation
|
59 | 52 |
|
60 | 53 | [https://clickhouse.com/docs/en/integrations/go](https://clickhouse.com/docs/en/integrations/go)
|
@@ -320,7 +313,7 @@ go get -u github.com/ClickHouse/clickhouse-go/v2
|
320 | 313 | * [batch struct](examples/clickhouse_api/append_struct.go)
|
321 | 314 | * [columnar](examples/clickhouse_api/columnar_insert.go)
|
322 | 315 | * [scan struct](examples/clickhouse_api/scan_struct.go)
|
323 |
| -* [query parameters](examples/clickhouse_api/query_parameters.go) (deprecated in favour of native query parameters) |
| 316 | +* [query parameters](examples/clickhouse_api/query_parameters.go) |
324 | 317 | * [bind params](examples/clickhouse_api/bind.go) (deprecated in favour of native query parameters)
|
325 | 318 | * [client info](examples/clickhouse_api/client_info.go)
|
326 | 319 |
|
|
0 commit comments