Skip to content

Commit 2bd4c82

Browse files
authored
Update README with newer Go versions (#1393)
1 parent 25b8902 commit 2bd4c82

File tree

1 file changed

+16
-23
lines changed

1 file changed

+16
-23
lines changed

README.md

+16-23
Original file line numberDiff line numberDiff line change
@@ -2,28 +2,6 @@
22

33
Golang SQL database client for [ClickHouse](https://clickhouse.com/).
44

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-
275
## Key features
286

297
* 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`:
5533
* Profile info
5634
* Profile events
5735

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+
5851
## Documentation
5952

6053
[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
320313
* [batch struct](examples/clickhouse_api/append_struct.go)
321314
* [columnar](examples/clickhouse_api/columnar_insert.go)
322315
* [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)
324317
* [bind params](examples/clickhouse_api/bind.go) (deprecated in favour of native query parameters)
325318
* [client info](examples/clickhouse_api/client_info.go)
326319

0 commit comments

Comments
 (0)