v2.6.1

2.6.1, 2023-02-13

Bug fixes

• Do not reuse expired connections (ConnMaxLifetime) #892 by @iamluc
• Extend default dial timeout value to 30s #893 by @jkaflik
• Compression name fixed in sendQuery log #884 by @fredgnr

v2.6.0

v2.6.0, 2023-01-27

New features

• Client info specification implementation #876 by @jkaflik

Bug fixes

• Better handling for broken connection errors in the std interface #879 by @n-oden

Chore

• Document way to provide table or database identifier with query parameters #875 by @jkaflik
• Bump github.com/ClickHouse/ch-go from 0.51.0 to 0.51.2 #881

v2.5.1

Bug fixes

• Flag connection as closed on broken pipe #871 by @n-oden

v2.5.0

New features

• Buffered compression column by column for a native protocol. Introduces the MaxCompressionBuffer option - max size (bytes) of compression buffer during column-by-column compression (default 10MiB) #808 by @gingerwizard and @jkaflik
• Support custom types that implement sql.Scanner interface (e.g. type customString string) #850 by @DarkDrim
• Append query options to the context instead of overwriting #860 by @aaron276h
• Query parameters support #854 by @jkaflik
• Expose DialStrategy function to the user for custom connection routing. #855 by @jkaflik

Bug fixes

• Close connection on Cancel. This is to make sure context timed out/canceled connection is not reused further #764 by @gingerwizard
• Fully parse secure and skip_verify in DSN query parameters. #862 by @n-oden

Chore

• Added tests covering read-only user queries #837 by @jkaflik
• Agreed on a batch append fail semantics #853 by @jkaflik

v2.4.3

Bug Fixes

• Fix in batch concurrency - batch could panic if used in separate go routines.

The issue was originally detected due to the use of a batch in a go routine and Abort being called after the connection was released on the batch. This would invalidate the connection which had been subsequently reassigned.

This issue could occur as soon as the conn is released (this can happen in a number of places e.g. after Send or an Append error), and it potentially returns to the pool for use in another go routine. Subsequent releases could then occur e.g., the user calls Abort mainly but also Send would do it. The result is the connection being closed in the release function while another batch or query potentially used it.

This release includes a guard to prevent release from being called more than once on a batch. It assumes that batches are not thread-safe - they aren't (only connections are).

v2.4.2

Bug Fixes

• Don't panic on Send() on batch after invalid Append - #830
• Fix JSON issue with nil if column order is inconsisent - #824

v2.4.1

Bug Fixes

• Patch release to fix "Regression - escape character was not considered when comparing column names" - #828

v2.4.0

New Features

1. Support for Nullables in Tuples - #821 #817
2. Use headers for auth and not url if SSL #811
3. Support additional headers - #811
4. Support int64 for DateTime #807
5. Support inserting Enums as int8/int16/int #802
6. Print error if unsupported server #792
7. Allow block buffer size to tuned for performance - see BlockBufferSize - #776
8. Support custom datetime in Scan - #767
9. Support insertion of an orderedmap - #763

Bug Fixes

1. Decompress errors over HTTP - #792
2. Use timezone vs timeZone so we work on older versions - #781
3. Ensure only columns specified in INSERT are required in batch - #79
4. Respect order of columns in insert for batch - #790
5. Handle double pointers for Nullable columns when batch inserting - #77
6. Use nil for LowCardinality(Nullable(X)) - #768

Breaking Changes

1. Align timezone handling with spec - #766, specifically:
   1. if parsing strings for datetime, datetime64 or dates we assume the locale is Local (i.e. the client) if not specified in the string.
   2. The server (or column tz) is used for datetime and datetime64 rendering. For date/date32, these have no tz info in the server. For now, they will be rendered as UTC - consistent with the clickhouse-client
   3. Addresses bind when no location is set

v2.3.0

• Support for uuid types via Scanner/Stringer #720
• Fix copylock when use sync.Pool in clickhouse.Pool #724
• Remove 128mb limit on block size for compression #721
• Fix Insertion into quoted table #715

v2.3.0-beta.2

v2.3.0-beta.2

Notes

• The release is beta as we only have support for Go 1.18. Will be promoted to GA on the release of Go 1.19.
• Utilizes ch-go v0.47.2.

New Features

• Support flush (experimental) on batch - allows multiple blocks per batch - #704
• Respect ReadTimeout for native - #699
• Support username/password passed as parameters in DSN - #691
• Support []byte for string - #688
• Support for sql.Null* types on equivalent ClickHouse types - #686
• Support for typed maps and slices for tuples (assuming identical sub-column types) - #685
• Default addresses for native and HTTP - localhost:9000 and localhost:8123, respectively. Handles nil Options. - #683
• Brotli compression support (for http) - #671
• Deflate compression support (for http) - #667
• Gzip compression support (for http) - #664
• Allow compression algorithm to be specified in DSN - #668
• Support for Array Sets in parameter binding - #659

Bug Fixes

• Fix handling of empty response over HTTP - #705
• Handle empty maps - #694
• Immutable options - #675
• Prevent maps from being used with unnamed tuples - #665
• Handle special chars in column names - #660