Skip to main content

2022 Changelog

ClickHouse release 22.12, 2022-12-15​

Danger

This release contains a faulty systemd service comment that might break the ClickHouse installation on upgrade for some Linux distributions. The systemd service changes the directory owner permissions on /run/systemd, causing all subsequent systemd operations to fail. It is advised that you skip upgrading to this version and instead upgrade to a newer version of ClickHouse.

Refer to this issue on GitHub for more details: https://github.com/ClickHouse/ClickHouse/issues/48285

Upgrade Notes​

  • Fixed backward incompatibility in (de)serialization of states of min, max, any*, argMin, argMax aggregate functions with String argument. The incompatibility affects 22.9, 22.10 and 22.11 branches (fixed since 22.9.6, 22.10.4 and 22.11.2 correspondingly). Some minor releases of 22.3, 22.7 and 22.8 branches are also affected: 22.3.13...22.3.14 (fixed since 22.3.15), 22.8.6...22.8.9 (fixed since 22.8.10), 22.7.6 and newer (will not be fixed in 22.7, we recommend upgrading from 22.7.* to 22.8.10 or newer). This release note does not concern users that have never used affected versions. Incompatible versions append an extra '\0' to strings when reading states of the aggregate functions mentioned above. For example, if an older version saved state of anyState('foobar') to state_column then the incompatible version will print 'foobar\0' on anyMerge(state_column). Also incompatible versions write states of the aggregate functions without trailing '\0'. Newer versions (that have the fix) can correctly read data written by all versions including incompatible versions, except one corner case. If an incompatible version saved a state with a string that actually ends with null character, then newer version will trim trailing '\0' when reading state of affected aggregate function. For example, if an incompatible version saved state of anyState('abrac\0dabra\0') to state_column then newer versions will print 'abrac\0dabra' on anyMerge(state_column). The issue also affects distributed queries when an incompatible version works in a cluster together with older or newer versions. #43038 (Alexander Tokmakov, Raúl Marín). Note: all the official ClickHouse builds already include the patches. This is not necessarily true for unofficial third-party builds that should be avoided.

New Feature​

  • Add BSONEachRow input/output format. In this format, ClickHouse formats/parses each row as a separate BSON document and each column is formatted/parsed as a single BSON field with the column name as the key. #42033 (mark-polokhov).
  • Add grace_hash JOIN algorithm, it can be enabled with SET join_algorithm = 'grace_hash'. #38191 (BigRedEye, Vladimir C).
  • Allow configuring password complexity rules and checks for creating and changing users. #43719 (Nikolay Degterinsky).
  • Mask sensitive information in logs; mask secret parts in the output of queries SHOW CREATE TABLE and SELECT FROM system.tables. Also resolves #41418. #43227 (Vitaly Baranov).
  • Add GROUP BY ALL syntax: #37631. #42265 (刘陶峰).
  • Add FROM table SELECT column syntax. #41095 (Nikolay Degterinsky).
  • Added function concatWithSeparator and concat_ws as an alias for Spark SQL compatibility. A function concatWithSeparatorAssumeInjective added as a variant to enable GROUP BY optimization, similarly to concatAssumeInjective. #43749 (李扬).
  • Added multiplyDecimal and divideDecimal functions for decimal operations with fixed precision. #42438 (Andrey Zvonov).
  • Added system.moves table with list of currently moving parts. #42660 (Sergei Trifonov).
  • Add support for embedded Prometheus endpoint for ClickHouse Keeper. #43087 (Antonio Andelic).
  • Support numeric literals with _ as the separator, for example, 1_000_000. #43925 (jh0x).
  • Added possibility to use an array as a second parameter for cutURLParameter function. It will cut multiple parameters. Close #6827. #43788 (Roman Vasin).
  • Add a column with the expression of the index in the system.data_skipping_indices table. #43308 (Guillaume Tassery).
  • Add column engine_full to system table databases so that users can access the entire engine definition of a database via system tables. #43468 (凌涛).
  • New hash function xxh3 added. Also, the performance of xxHash32 and xxHash64 are improved on ARM thanks to a library update. #43411 (Nikita Taranov).
  • Added support to define constraints for merge tree settings. For example you can forbid overriding the storage_policy by users. #43903 (Sergei Trifonov).
  • Add a new setting input_format_json_read_objects_as_strings that allows the parsing of nested JSON objects into Strings in all JSON input formats. This setting is disabled by default. #44052 (Kruglov Pavel).

Experimental Feature​

  • Support deduplication for asynchronous inserts. Before this change, async inserts did not support deduplication, because multiple small inserts coexisted in one inserted batch. Closes #38075. #43304 (Han Fei).
  • Add support for cosine distance for the experimental Annoy (vector similarity search) index. #42778 (Filatenkov Artur).
  • Add CREATE / ALTER / DROP NAMED COLLECTION queries. #43252 (Kseniia Sumarokova). This feature is under development and the queries are not effective as of version 22.12. This changelog entry is added only to avoid confusion. Restrict default access to named collections to the user defined in config. This requires that show_named_collections = 1 is set to be able to see them. #43325 (Kseniia Sumarokova). The system.named_collections table is introduced #43147 (Kseniia Sumarokova).

Performance Improvement​

  • Add settings max_streams_for_merge_tree_reading and allow_asynchronous_read_from_io_pool_for_merge_tree. Setting max_streams_for_merge_tree_reading limits the number of reading streams for MergeTree tables. Setting allow_asynchronous_read_from_io_pool_for_merge_tree enables a background I/O pool to read from MergeTree tables. This may increase performance for I/O bound queries if used together with max_streams_to_max_threads_ratio or max_streams_for_merge_tree_reading. #43260 (Nikolai Kochetov). This improves performance up to 100 times in case of high latency storage, low number of CPU and high number of data parts.
  • Settings merge_tree_min_rows_for_concurrent_read_for_remote_filesystem/merge_tree_min_bytes_for_concurrent_read_for_remote_filesystem did not respect adaptive granularity. Fat rows did not decrease the number of read rows (as it was done for merge_tree_min_rows_for_concurrent_read/merge_tree_min_bytes_for_concurrent_read, which could lead to high memory usage when using remote filesystems. #43965 (Nikolai Kochetov).
  • Optimized the number of list requests to ZooKeeper or ClickHouse Keeper when selecting a part to merge. Previously it could produce thousands of requests in some cases. Fixes #43647. #43675 (Alexander Tokmakov).
  • Optimization is getting skipped now if max_size_to_preallocate_for_aggregation has too small a value. The default value of this setting increased to 10^8. #43945 (Nikita Taranov).
  • Speed-up server shutdown by avoiding cleaning up of old data parts. Because it is unnecessary after https://github.com/ClickHouse/ClickHouse/pull/41145. #43760 (Sema Checherinda).
  • Merging on initiator now uses the same memory bound approach as merging of local aggregation results if enable_memory_bound_merging_of_aggregation_results is set. #40879 (Nikita Taranov).
  • Keeper improvement: try syncing logs to disk in parallel with replication. #43450 (Antonio Andelic).
  • Keeper improvement: requests are batched more often. The batching can be controlled with the new setting max_requests_quick_batch_size. #43686 (Antonio Andelic).

Improvement​

  • Implement referential dependencies and use them to create tables in the correct order while restoring from a backup. #43834 (Vitaly Baranov).
  • Substitute UDFs in CREATE query to avoid failures during loading at startup. Additionally, UDFs can now be used as DEFAULT expressions for columns. #43539 (Antonio Andelic).
  • Change how the following queries delete parts: TRUNCATE TABLE, ALTER TABLE DROP PART, ALTER TABLE DROP PARTITION. Now, these queries make empty parts which cover the old parts. This makes the TRUNCATE query work without a followedexclusive lock which means concurrent reads aren't locked. Also achieved durability in all those queries. If the request succeeds, then no resurrected parts appear later. Note that atomicity is achieved only with transaction scope. #41145 (Sema Checherinda).
  • SET param_x query no longer requires manual string serialization for the value of the parameter. For example, query SET param_a = '[\'a\', \'b\']' can now be written like SET param_a = ['a', 'b']. #41874 (Nikolay Degterinsky).
  • Show read rows in the progress indication while reading from STDIN from client. Closes #43423. #43442 (Kseniia Sumarokova).
  • Show progress bar while reading from s3 table function / engine. #43454 (Kseniia Sumarokova).
  • Progress bar will show both read and written rows. #43496 (Ilya Yatsishin).
  • filesystemAvailable and related functions support one optional argument with disk name, and change filesystemFree to filesystemUnreserved. Closes #35076. #42064 (flynn).
  • Integration with LDAP: increased the default value of search_limit to 256, and added LDAP server config option to change that to an arbitrary value. Closes: #42276. #42461 (Vasily Nemkov).
  • Allow the removal of sensitive information (see the query_masking_rules in the configuration file) from the exception messages as well. Resolves #41418. #42940 (filimonov).
  • Support queries like SHOW FULL TABLES ... for MySQL compatibility. #43910 (Filatenkov Artur).
  • Keeper improvement: Add 4lw command rqld which can manually assign a node as leader. #43026 (JackyWoo).
  • Apply connection timeout settings for Distributed async INSERT from the query. #43156 (Azat Khuzhin).
  • The unhex function now supports FixedString arguments. issue42369. #43207 (DR).
  • Priority is given to deleting completely expired parts according to the TTL rules, see #42869. #43222 (zhongyuankai).
  • More precise and reactive CPU load indication in clickhouse-client. #43307 (Sergei Trifonov).
  • Support reading of subcolumns of nested types from storage S3 and table function s3 with formats Parquet, Arrow and ORC. #43329 (chen).
  • Add table_uuid column to the system.parts table. #43404 (Azat Khuzhin).
  • Added client option to display the number of locally processed rows in non-interactive mode (--print-num-processed-rows). #43407 (jh0x).
  • Implement aggregation-in-order optimization on top of a query plan. It is enabled by default (but works only together with optimize_aggregation_in_order, which is disabled by default). Set query_plan_aggregation_in_order = 0 to use the previous AST-based version. #43592 (Nikolai Kochetov).
  • Allow to collect profile events with trace_type = 'ProfileEvent' to system.trace_log on each increment with current stack, profile event name and value of the increment. It can be enabled by the setting trace_profile_events and used to investigate performance of queries. #43639 (Anton Popov).
  • Add a new setting input_format_max_binary_string_size to limit string size in RowBinary format. #43842 (Kruglov Pavel).
  • When ClickHouse requests a remote HTTP server, and it returns an error, the numeric HTTP code was not displayed correctly in the exception message. Closes #43919. #43920 (Alexey Milovidov).
  • Correctly report errors in queries even when multiple JOINs optimization is taking place. #43583 (Salvatore).

Build/Testing/Packaging Improvement​

Bug Fix (user-visible misbehavior in official stable or prestable release)​

  • Fixed bug which could lead to deadlock while using asynchronous inserts. #43233 (Anton Popov).
  • Fix some incorrect logic in AST level optimization optimize_normalize_count_variants. #43873 (Duc Canh Le).
  • Fix a case when mutations are not making progress when checksums do not match between replicas (e.g. caused by a change in data format on an upgrade). #36877 (nvartolomei).
  • Fix the skip_unavailable_shards optimization which did not work with the hdfsCluster table function. #43236 (chen).
  • Fix s3 support for the ? wildcard. Closes #42731. #43253 (chen).
  • Fix functions arrayFirstOrNull and arrayLastOrNull or null when the array contains Nullable elements. #43274 (Duc Canh Le).
  • Fix incorrect UserTimeMicroseconds/SystemTimeMicroseconds accounting related to Kafka tables. #42791 (Azat Khuzhin).
  • Do not suppress exceptions in web disks. Fix retries for the web disk. #42800 (Azat Khuzhin).
  • Fixed (logical) race condition between inserts and dropping materialized views. A race condition happened when a Materialized View was dropped at the same time as an INSERT, where the MVs were present as a dependency of the insert at the begining of the execution, but the table has been dropped by the time the insert chain tries to access it, producing either an UNKNOWN_TABLE or TABLE_IS_DROPPED exception, and stopping the insertion. After this change, we avoid these exceptions and just continue with the insert if the dependency is gone. #43161 (AlfVII).
  • Fix undefined behavior in the quantiles function, which might lead to uninitialized memory. Found by fuzzer. This closes #44066. #44067 (Alexey Milovidov).
  • Additional check on zero uncompressed size is added to CompressionCodecDelta. #43255 (Nikita Taranov).
  • Flatten arrays from Parquet to avoid an issue with inconsistent data in arrays. These incorrect files can be generated by Apache Iceberg. #43297 (Arthur Passos).
  • Fix bad cast from LowCardinality column when using short circuit function execution. #43311 (Kruglov Pavel).
  • Fixed queries with SAMPLE BY with prewhere optimization on tables using Merge engine. #43315 (Antonio Andelic).
  • Check and compare the content of the format_version file in MergeTreeData so that tables can be loaded even if the storage policy was changed. #43328 (Antonio Andelic).
  • Fix possible (very unlikely) "No column to rollback" logical error during INSERT into Buffer tables. #43336 (Azat Khuzhin).
  • Fix a bug that allowed the parser to parse an unlimited amount of round brackets into one function if allow_function_parameters is set. #43350 (Nikolay Degterinsky).
  • MaterializeMySQL (experimental feature) support DDL： drop table t1, t2 and compatible with most of MySQL DROP DDL. #43366 (zzsmdfj).
  • session_log (experimental feature): Fixed the inability to log in (because of failure to create the session_log entry) in a very rare case of messed up setting profiles. #42641 (Vasily Nemkov).
  • Fix possible Cannot create non-empty column with type Nothing in functions if/multiIf. Closes #43356. #43368 (Kruglov Pavel).
  • Fix a bug when a row level filter uses the default value of a column. #43387 (Alexander Gololobov).
  • Query with DISTINCT + LIMIT BY + LIMIT can return fewer rows than expected. Fixes #43377. #43410 (Igor Nikonov).
  • Fix sumMap for Nullable(Decimal(...)). #43414 (Azat Khuzhin).
  • Fix date_diff for hour/minute on macOS. Close #42742. #43466 (zzsmdfj).
  • Fix incorrect memory accounting because of merges/mutations. #43516 (Azat Khuzhin).
  • Fixed primary key analysis with conditions involving toString(enum). #43596 (Nikita Taranov). This error has been found by @tisonkun.
  • Ensure consistency when clickhouse-copier updates status and attach_is_done in Keeper after partition attach is done. #43602 (lzydmxy).
  • During the recovery of a lost replica of a Replicated database (experimental feature), there could a situation where we need to atomically swap two table names (use EXCHANGE). Previously we tried to use two RENAME queries, which was obviously failing and moreover, failed the whole recovery process of the database replica. #43628 (Nikita Mikhaylov).
  • Fix the case when the s3Cluster function throws NOT_FOUND_COLUMN_IN_BLOCK error. Closes #43534. #43629 (chen).
  • Fix possible logical error Array sizes mismatched while parsing JSON object with arrays with same key names but with different nesting level. Closes #43569. #43693 (Kruglov Pavel).
  • Fixed possible exception in the case of distributed GROUP BY with an ALIAS column among aggregation keys. #43709 (Nikita Taranov).
  • Fix bug which can lead to broken projections if zero-copy replication (experimental feature) is enabled and used. #43764 (alesapin).
  • Fix using multipart upload for very large S3 objects in AWS S3. #43824 (ianton-ru).
  • Fixed ALTER ... RESET SETTING with ON CLUSTER. It could have been applied to one replica only. Fixes #43843. #43848 (Elena Torró).
  • Fix a logical error in JOIN with Join table engine at right hand side, if USING is being used. #43963 (Vladimir C). Fix a bug with wrong order of keys in Join table engine. #44012 (Vladimir C).
  • Keeper fix: throw if the interserver port for Raft is already in use. #43984 (Antonio Andelic).
  • Fix ORDER BY positional argument (example: ORDER BY 1, 2) in case of unneeded columns pruning from subqueries. Closes #43964. #43987 (Kseniia Sumarokova).
  • Fixed exception when a subquery contains HAVING but doesn't contain an actual aggregation. #44051 (Nikita Taranov).
  • Fix race in s3 multipart upload. This race could cause the error Part number must be an integer between 1 and 10000, inclusive. (S3_ERROR) while restoring from a backup. #44065 (Vitaly Baranov).

ClickHouse release 22.11, 2022-11-17​

Backward Incompatible Change​

  • JSONExtract family of functions will now attempt to coerce to the requested type. #41502 (Márcio Martins).

New Feature​

  • Adds support for retries during INSERTs into ReplicatedMergeTree when a session with ClickHouse Keeper is lost. Apart from fault tolerance, it aims to provide better user experience, - avoid returning a user an error during insert if keeper is restarted (for example, due to upgrade). #42607 (Igor Nikonov).
  • Add Hudi and DeltaLake table engines, read-only, only for tables on S3. #41054 (Daniil Rubin, Kseniia Sumarokova).
  • Add table function hudi and deltaLake. #43080 (flynn).
  • Support for composite time intervals. 1. Add, subtract and negate operations are now available on Intervals. In the case where the types of Intervals are different, they will be transformed into the Tuple of those types. 2. A tuple of intervals can be added to or subtracted from a Date/DateTime field. 3. Added parsing of Intervals with different types, for example: INTERVAL '1 HOUR 1 MINUTE 1 SECOND'. #42195 (Nikolay Degterinsky).
  • Added ** glob support for recursive directory traversal of the filesystem and S3. Resolves #36316. #42376 (SmitaRKulkarni).
  • Introduce s3_plain disk type for write-once-read-many operations. Implement ATTACH of MergeTree table for s3_plain disk. #42628 (Azat Khuzhin).
  • Added applied row-level policies to system.query_log. #39819 (Vladimir Chebotaryov).
  • Add four-letter command csnp for manually creating snapshots in ClickHouse Keeper. Additionally, lgif was added to get Raft information for a specific node (e.g. index of last created snapshot, last committed log index). #41766 (JackyWoo).
  • Add function ascii like in Apache Spark: https://spark.apache.org/docs/latest/api/sql/#ascii. #42670 (李扬).
  • Add function pmod which returns non-negative result based on modulo. #42755 (李扬).
  • Add function formatReadableDecimalSize. #42774 (Alejandro).
  • Add function randCanonical, which is similar to the rand function in Apache Spark or Impala. The function generates pseudo random results with independent and identically distributed uniformly distributed values in [0, 1). #43124 (李扬).
  • Add function displayName, closes #36770. #37681 (hongbin).
  • Add min_age_to_force_merge_on_partition_only setting to optimize old parts for the entire partition only. #42659 (Antonio Andelic).
  • Add generic implementation for arbitrary structured named collections, access type and system.named_collections. #43147 (Kseniia Sumarokova).

Performance Improvement​

  • match function can use the index if it's a condition on string prefix. This closes #37333. #42458 (clarkcaoliu).
  • Speed up AND and OR operators when they are sequenced. #42214 (Zhiguo Zhou).
  • Support parallel parsing for LineAsString input format. This improves performance just slightly. This closes #42502. #42780 (Kruglov Pavel).
  • ClickHouse Keeper performance improvement: improve commit performance for cases when many different nodes have uncommitted states. This should help with cases when a follower node can't sync fast enough. #42926 (Antonio Andelic).
  • A condition like NOT LIKE 'prefix%' can use the primary index. #42209 (Duc Canh Le).

Experimental Feature​

Improvement​

  • Trivial queries with small LIMIT will properly determine the number of estimated rows to read, so that the threshold will be checked properly. Closes #7071. #42580 (Han Fei).
  • Add support for interactive parameters in INSERT VALUES queries. #43077 (Nikolay Degterinsky).
  • Added new field allow_readonly in system.table_functions to allow using table functions in readonly mode. Resolves #42414 Implementation: Added a new field allow_readonly to table system.table_functions. Updated to use new field allow_readonly to allow using table functions in readonly mode. Testing: Added a test for filesystem tests/queries/0_stateless/02473_functions_in_readonly_mode.sh Documentation: Updated the english documentation for Table Functions. #42708 (SmitaRKulkarni).
  • The system.asynchronous_metrics gets embedded documentation. This documentation is also exported to Prometheus. Fixed an error with the metrics about cache disks - they were calculated only for one arbitrary cache disk instead all of them. This closes #7644. #43194 (Alexey Milovidov).
  • Throttling algorithm changed to token bucket. #42665 (Sergei Trifonov).
  • Mask passwords and secret keys both in system.query_log and /var/log/clickhouse-server/*.log and also in error messages. #42484 (Vitaly Baranov).
  • Remove covered parts for fetched part (to avoid possible replication delay grows). #39737 (Azat Khuzhin).
  • If /dev/tty is available, the progress in clickhouse-client and clickhouse-local will be rendered directly to the terminal, without writing to STDERR. It allows getting progress even if STDERR is redirected to a file, and the file will not be polluted by terminal escape sequences. The progress can be disabled by --progress false. This closes #32238. #42003 (Alexey Milovidov).
  • Add support for FixedString input to base64 coding functions. #42285 (ltrk2).
  • Add columns bytes_on_disk and path to system.detached_parts. Closes #42264. #42303 (chen).
  • Improve using structure from insertion table in table functions, now setting use_structure_from_insertion_table_in_table_functions has new possible value - 2 that means that ClickHouse will try to determine if we can use structure from insertion table or not automatically. Closes #40028. #42320 (Kruglov Pavel).
  • Fix no progress indication on INSERT FROM INFILE. Closes #42548. #42634 (chen).
  • Refactor function tokens to enable max tokens returned for related functions (disabled by default). #42673 (李扬).
  • Allow to use Date32 arguments for formatDateTime and FROM_UNIXTIME functions. #42737 (Roman Vasin).
  • Update tzdata to 2022f. Mexico will no longer observe DST except near the US border: https://www.timeanddate.com/news/time/mexico-abolishes-dst-2022.html. Chihuahua moves to year-round UTC-6 on 2022-10-30. Fiji no longer observes DST. See https://github.com/google/cctz/pull/235 and https://bugs.launchpad.net/ubuntu/+source/tzdata/+bug/1995209. #42796 (Alexey Milovidov).
  • Add FailedAsyncInsertQuery event metric for async inserts. #42814 (Krzysztof Góralski).
  • Implement read-in-order optimization on top of query plan. It is enabled by default. Set query_plan_read_in_order = 0 to use previous AST-based version. #42829 (Nikolai Kochetov).
  • Increase the size of upload part exponentially for backup to S3 to avoid errors about max 10 000 parts limit of the multipart upload to s3. #42833 (Vitaly Baranov).
  • When the merge task is continuously busy and the disk space is insufficient, the completely expired parts cannot be selected and dropped, resulting in insufficient disk space. My idea is that when the entire Part expires, there is no need for additional disk space to guarantee, ensure the normal execution of TTL. #42869 (zhongyuankai).
  • Add oss function and OSS table engine (this is convenient for users). oss is fully compatible with s3. #43155 (zzsmdfj).
  • Improve error reporting in the collection of OS-related info for the system.asynchronous_metrics table. #43192 (Alexey Milovidov).
  • Modify the INFORMATION_SCHEMA tables in a way so that ClickHouse can connect to itself using the MySQL compatibility protocol. Add columns instead of aliases (related to #9769). It will improve the compatibility with various MySQL clients. #43198 (Filatenkov Artur).
  • Add some functions for compatibility with PowerBI, when it connects using MySQL protocol #42612 (Filatenkov Artur).
  • Better usability for Dashboard on changes #42872 (Vladimir C).

Build/Testing/Packaging Improvement​

Bug Fix (user-visible misbehavior in official stable or prestable release)​

  • Updated normaliser to clone the alias ast. Resolves #42452 Implementation: Updated QueryNormalizer to clone alias ast, when its replaced. Previously just assigning the same leads to exception in LogicalExpressinsOptimizer as it would be the same parent being inserted again. This bug is not seen with new analyser (allow_experimental_analyzer), so no changes for it. I added a test for the same. #42827 (SmitaRKulkarni).
  • Fix race for backup of tables in Lazy databases. #43104 (Vitaly Baranov).
  • Fix for skip_unavailable_shards: it did not work with the s3Cluster table function. #43131 (chen).
  • Fix schema inference in s3Cluster and improvement in hdfsCluster. #41979 (Kruglov Pavel).
  • Fix retries while reading from URL table engines / table function. (retriable errors could be retries more times than needed, non-retriable errors resulted in failed assertion in code). #42224 (Kseniia Sumarokova).
  • A segmentation fault related to DNS & c-ares has been reported and fixed. #42234 (Arthur Passos).
  • Fix LOGICAL_ERROR Arguments of 'plus' have incorrect data types which may happen in PK analysis (monotonicity check). Fix invalid PK analysis for monotonic binary functions with first constant argument. #42410 (Nikolai Kochetov).
  • Fix incorrect key analysis when key types cannot be inside Nullable. This fixes #42456. #42469 (Amos Bird).
  • Fix typo in a setting name that led to bad usage of schema inference cache while using setting input_format_csv_use_best_effort_in_schema_inference. Closes #41735. #42536 (Kruglov Pavel).
  • Fix creating a Set with wrong header when data type is LowCardinality. Closes #42460. #42579 (flynn).
  • (U)Int128 and (U)Int256 values were correctly checked in PREWHERE. #42605 (Antonio Andelic).
  • Fix a bug in functions parser that could have led to a segmentation fault. #42724 (Nikolay Degterinsky).
  • Fix the locking in truncate table. #42728 (flynn).
  • Fix possible crash in web disks when file does not exist (or OPTIMIZE TABLE FINAL, that also can got the same error eventually). #42767 (Azat Khuzhin).
  • Fix auth_type mapping in system.session_log, by including SSL_CERTIFICATE for the enum values. #42782 (Miel Donkers).
  • Fix stack-use-after-return under ASAN build in the Create User query parser. #42804 (Nikolay Degterinsky).
  • Fix lowerUTF8/upperUTF8 in case of symbol was in between 16-byte boundary (very frequent case of you have strings > 16 bytes long). #42812 (Azat Khuzhin).
  • Additional bound check was added to LZ4 decompression routine to fix misbehaviour in case of malformed input. #42868 (Nikita Taranov).
  • Fix rare possible hang on query cancellation. #42874 (Azat Khuzhin).
  • Fix incorrect behavior with multiple disjuncts in hash join, close #42832. #42876 (Vladimir C).
  • A null pointer will be generated when select if as from ‘three table join’ , For example, this SQL query: #42883 (zzsmdfj).
  • Fix memory sanitizer report in Cluster Discovery, close #42763. #42905 (Vladimir C).
  • Improve DateTime schema inference in case of empty string. #42911 (Kruglov Pavel).
  • Fix rare NOT_FOUND_COLUMN_IN_BLOCK error when projection is possible to use but there is no projection available. This fixes #42771 . The bug was introduced in https://github.com/ClickHouse/ClickHouse/pull/25563. #42938 (Amos Bird).
  • Fix ATTACH TABLE in PostgreSQL database engine if the table contains DATETIME data type. Closes #42817. #42960 (Kseniia Sumarokova).
  • Fix lambda parsing. Closes #41848. #42979 (Nikolay Degterinsky).
  • Fix incorrect key analysis when nullable keys appear in the middle of a hyperrectangle. This fixes #43111 . #43133 (Amos Bird).
  • Fix several buffer over-reads in deserialization of carefully crafted aggregate function states. #43159 (Raúl Marín).
  • Fix function if in case of NULL and const Nullable arguments. Closes #43069. #43178 (Kruglov Pavel).
  • Fix decimal math overflow in parsing DateTime with the 'best effort' algorithm. Closes #43061. #43180 (Kruglov Pavel).
  • The indent field produced by the git-import tool was miscalculated. See https://clickhouse.com/docs/en/getting-started/example-datasets/github/. #43191 (Alexey Milovidov).
  • Fixed unexpected behaviour of Interval types with subquery and casting. #43193 (jh0x).

ClickHouse release 22.10, 2022-10-25​

Backward Incompatible Change​

  • Rename cache commands: show caches -> show filesystem caches, describe cache -> describe filesystem cache. #41508 (Kseniia Sumarokova).
  • Remove support for the WITH TIMEOUT section for LIVE VIEW. This closes #40557. #42173 (Alexey Milovidov).
  • Remove support for the {database} macro from the client's prompt. It was displayed incorrectly if the database was unspecified and it was not updated on USE statements. This closes #25891. #42508 (Alexey Milovidov).

New Feature​

  • Composable protocol configuration is added. Now different protocols can be set up with different listen hosts. Protocol wrappers such as PROXYv1 can be set up over any other protocols (TCP, TCP secure, MySQL, Postgres). #41198 (Yakov Olkhovskiy).
  • Add S3 as a new type of the destination of backups. Support BACKUP to S3 with as-is path/data structure. #42333 (Vitaly Baranov), #42232 (Azat Khuzhin).
  • Added functions (randUniform, randNormal, randLogNormal, randExponential, randChiSquared, randStudentT, randFisherF, randBernoulli, randBinomial, randNegativeBinomial, randPoisson) to generate random values according to the specified distributions. This closes #21834. #42411 (Nikita Mikhaylov).
  • An improvement for ClickHouse Keeper: add support for uploading snapshots to S3. S3 information can be defined inside keeper_server.s3_snapshot. #41342 (Antonio Andelic).
  • Added an aggregate function analysisOfVariance (anova) to perform a statistical test over several groups of normally distributed observations to find out whether all groups have the same mean or not. Original PR #37872. #42131 (Nikita Mikhaylov).
  • Support limiting of temporary data stored on disk using settings max_temporary_data_on_disk_size_for_user/max_temporary_data_on_disk_size_for_query . #40893 (Vladimir C).
  • Add setting format_json_object_each_row_column_for_object_name to write/parse object name as column value in JSONObjectEachRow format. #41703 (Kruglov Pavel).
  • Add BLAKE3 hash-function to SQL. #33435 (BoloniniD).
  • The function javaHash has been extended to integers. #41131 (JackyWoo).
  • Add OpenTelemetry support to ON CLUSTER DDL (require distributed_ddl_entry_format_version to be set to 4). #41484 (Frank Chen).
  • Added system table asynchronous_insert_log. It contains information about asynchronous inserts (including results of queries in fire-and-forget mode (with wait_for_async_insert=0)) for better introspection. #42040 (Anton Popov).
  • Add support for methods lz4, bz2, snappy in HTTP's Accept-Encoding which is a non-standard extension to HTTP protocol. #42071 (Nikolay Degterinsky).
  • Adds Morton Coding (ZCurve) encode/decode functions. #41753 (Constantine Peresypkin).
  • Add support for SET setting_name = DEFAULT. #42187 (Filatenkov Artur).

Experimental Feature​

  • Added new infrastructure for query analysis and planning under the allow_experimental_analyzer setting. #31796 (Maksim Kita).
  • Initial implementation of Kusto Query Language. Please don't use it. #37961 (Yong Wang).

Performance Improvement​

  • Relax the "Too many parts" threshold. This closes #6551. Now ClickHouse will allow more parts in a partition if the average part size is large enough (at least 10 GiB). This allows to have up to petabytes of data in a single partition of a single table on a single server, which is possible using disk shelves or object storage. #42002 (Alexey Milovidov).
  • Implement operator precedence element parser to make the required stack size smaller. #34892 (Nikolay Degterinsky).
  • DISTINCT in order optimization leverage sorting properties of data streams. This improvement will enable reading in order for DISTINCT if applicable (before it was necessary to provide ORDER BY for columns in DISTINCT). #41014 (Igor Nikonov).
  • ColumnVector: optimize UInt8 index with AVX512VBMI. #41247 (Guo Wangyang).
  • Optimize the lock contentions for ThreadGroupStatus::mutex. The performance experiments of SSB (Star Schema Benchmark) on the ICX device (Intel Xeon Platinum 8380 CPU, 80 cores, 160 threads) shows that this change could bring a 2.95x improvement of the geomean of all subcases' QPS. #41675 (Zhiguo Zhou).
  • Add ldapr capabilities to AArch64 builds. This is supported from Graviton 2+, Azure and GCP instances. Only appeared in clang-15 not so long ago. #41778 (Daniel Kutenin).
  • Improve performance when comparing strings and one argument is an empty constant string. #41870 (Jiebin Sun).
  • Optimize insertFrom of ColumnAggregateFunction to share Aggregate State in some cases. #41960 (flynn).
  • Make writing to azure_blob_storage disks faster (respect max_single_part_upload_size instead of writing a block per each buffer size). Inefficiency mentioned in #41754. #42041 (Kseniia Sumarokova).
  • Make thread ids in the process list and query_log unique to avoid waste. #42180 (Alexey Milovidov).
  • Support skipping cache completely (both download to cache and reading cached data) in case the requested read range exceeds the threshold defined by cache setting bypass_cache_threashold, requires to be enabled with enable_bypass_cache_with_threshold). #42418 (Han Shukai). This helps on slow local disks.

Improvement​

  • Add setting allow_implicit_no_password: in combination with allow_no_password it forbids creating a user with no password unless IDENTIFIED WITH no_password is explicitly specified. #41341 (Nikolay Degterinsky).
  • Embedded Keeper will always start in the background allowing ClickHouse to start without achieving quorum. #40991 (Antonio Andelic).
  • Made reestablishing a new connection to ZooKeeper more reactive in case of expiration of the previous one. Previously there was a task which spawns every minute by default and thus a table could be in readonly state for about this time. #41092 (Nikita Mikhaylov).
  • Now projections can be used with zero copy replication (zero-copy replication is a non-production feature). #41147 (alesapin).
  • Support expression (EXPLAIN SELECT ...) in a subquery. Queries like SELECT * FROM (EXPLAIN PIPELINE SELECT col FROM TABLE ORDER BY col) became valid. #40630 (Vladimir C).
  • Allow changing async_insert_max_data_size or async_insert_busy_timeout_ms in scope of query. E.g. user wants to insert data rarely and she doesn't have access to the server config to tune default settings. #40668 (Nikita Mikhaylov).
  • Improvements for reading from remote filesystems, made threadpool size for reads/writes configurable. Closes #41070. #41011 (Kseniia Sumarokova).
  • Support all combinators combination in WindowTransform/arratReduce*/initializeAggregation/aggregate functions versioning. Previously combinators like ForEach/Resample/Map didn't work in these places, using them led to exception likeState function ... inserts results into non-state column. #41107 (Kruglov Pavel).
  • Add function tryDecrypt that returns NULL when decrypt fails (e.g. decrypt with incorrect key) instead of throwing an exception. #41206 (Duc Canh Le).
  • Add the unreserved_space column to the system.disks table to check how much space is not taken by reservations per disk. #41254 (filimonov).
  • Support s3 authorization headers in table function arguments. #41261 (Kseniia Sumarokova).
  • Add support for MultiRead in Keeper and internal ZooKeeper client (this is an extension to ZooKeeper protocol, only available in ClickHouse Keeper). #41410 (Antonio Andelic).
  • Add support for decimal type comparing with floating point literal in IN operator. #41544 (liang.huang).
  • Allow readable size values (like 1TB) in cache config. #41688 (Kseniia Sumarokova).
  • ClickHouse could cache stale DNS entries for some period of time (15 seconds by default) until the cache won't be updated asynchronously. During these periods ClickHouse can nevertheless try to establish a connection and produce errors. This behavior is fixed. #41707 (Nikita Mikhaylov).
  • Add interactive history search with fzf-like utility (fzf/sk) for clickhouse-client/clickhouse-local (note you can use FZF_DEFAULT_OPTS/SKIM_DEFAULT_OPTIONS to additionally configure the behavior). #41730 (Azat Khuzhin).
  • Only allow clients connecting to a secure server with an invalid certificate only to proceed with the '--accept-certificate' flag. #41743 (Yakov Olkhovskiy).
  • Add function tryBase58Decode, similar to the existing function tryBase64Decode. #41824 (Robert Schulze).
  • Improve feedback when replacing partition with different primary key. Fixes #34798. #41838 (Salvatore).
  • Fix parallel parsing: segmentator now checks max_block_size. This fixed memory overallocation in case of parallel parsing and small LIMIT. #41852 (Vitaly Baranov).
  • Don't add "TABLE_IS_DROPPED" exception to system.errors if it's happened during SELECT from a system table and was ignored. #41908 (AlfVII).
  • Improve option enable_extended_results_for_datetime_functions to return results of type DateTime64 for functions toStartOfDay, toStartOfHour, toStartOfFifteenMinutes, toStartOfTenMinutes, toStartOfFiveMinutes, toStartOfMinute and timeSlot. #41910 (Roman Vasin).
  • Improve DateTime type inference for text formats. Now it respects setting date_time_input_format and doesn't try to infer datetimes from numbers as timestamps. Closes #41389 Closes #42206. #41912 (Kruglov Pavel).
  • Remove confusing warning when inserting with perform_ttl_move_on_insert = false. #41980 (Vitaly Baranov).
  • Allow user to write countState(*) similar to count(*). This closes #9338. #41983 (Amos Bird).
  • Fix rankCorr size overflow. #42020 (Duc Canh Le).
  • Added an option to specify an arbitrary string as an environment name in the Sentry's config for more handy reports. #42037 (Nikita Mikhaylov).
  • Fix parsing out-of-range Date from CSV. #42044 (Andrey Zvonov).
  • parseDataTimeBestEffort now supports comma between date and time. Closes #42038. #42049 (flynn).
  • Improved stale replica recovery process for ReplicatedMergeTree. If a lost replica has some parts which are absent from a healthy replica, but these parts should appear in the future according to the replication queue of the healthy replica, then the lost replica will keep such parts instead of detaching them. #42134 (Alexander Tokmakov).
  • Add a possibility to use Date32 arguments for date_diff function. Fix issue in date_diff function when using DateTime64 arguments with a start date before Unix epoch and end date after Unix epoch. #42308 (Roman Vasin).
  • When uploading big parts to Minio, 'Complete Multipart Upload' can take a long time. Minio sends heartbeats every 10 seconds (see https://github.com/minio/minio/pull/7198). But clickhouse times out earlier, because the default send/receive timeout is set to 5 seconds. #42321 (filimonov).
  • Fix rarely invalid cast of aggregate state types with complex types such as Decimal. This fixes #42408. #42417 (Amos Bird).
  • Allow to use Date32 arguments for dateName function. #42554 (Roman Vasin).
  • Now filters with NULL literals will be used during index analysis. #34063. #41842 (Amos Bird).
  • Merge parts if every part in the range is older than a certain threshold. The threshold can be set by using min_age_to_force_merge_seconds. This closes #35836. #42423 (Antonio Andelic). This is continuation of #39550i by @fastio who implemented most of the logic.
  • Added new infrastructure for query analysis and planning under allow_experimental_analyzer setting. #31796 (Maksim Kita).
  • Improve the time to recover lost keeper connections. #42541 (Raúl Marín).

Build/Testing/Packaging Improvement​

  • Add fuzzer for table definitions #40096 (Anton Popov). This represents the biggest advancement for ClickHouse testing in this year so far.
  • Beta version of the ClickHouse Cloud service is released: https://clickhouse.cloud/. It provides the easiest way to use ClickHouse (even slightly easier than the single-command installation).
  • Added support of WHERE clause generation to AST Fuzzer and possibility to add or remove ORDER BY and WHERE clause. #38519 (Ilya Yatsishin).
  • Aarch64 binaries now require at least ARMv8.2, released in 2016. Most notably, this enables use of ARM LSE, i.e. native atomic operations. Also, CMake build option "NO_ARMV81_OR_HIGHER" has been added to allow compilation of binaries for older ARMv8.0 hardware, e.g. Raspberry Pi 4. #41610 (Robert Schulze).
  • Allow building ClickHouse with Musl (small changes after it was already supported but broken). #41987 (Alexey Milovidov).
  • Add the $CLICKHOUSE_CRONFILE file checking to avoid running the sed command to get the file not found error on install. #42081 (Chun-Sheng, Li).
  • Update cctz to 2022e to support the new timezone changes. Palestine transitions are now Saturdays at 02:00. Simplify three Ukraine zones into one. Jordan and Syria switch from +02/+03 with DST to year-round +03. (https://data.iana.org/time-zones/tzdb/NEWS). This closes #42252. #42327 (Alexey Milovidov). #42273 (Dom Del Nano).
  • Add Rust code support into ClickHouse with BLAKE3 hash-function library as an example. #33435 (BoloniniD).

Bug Fix (user-visible misbehavior in official stable or prestable release)​

  • Choose correct aggregation method for LowCardinality with big integer types. #42342 (Duc Canh Le).
  • Several fixes for web disk. #41652 (Kseniia Sumarokova).
  • Fixes an issue that causes docker run to fail if https_port is not present in config. #41693 (Yakov Olkhovskiy).
  • Mutations were not cancelled properly on server shutdown or SYSTEM STOP MERGES query and cancellation might take long time, it's fixed. #41699 (Alexander Tokmakov).
  • Fix wrong result of queries with ORDER BY or GROUP BY by columns from prefix of sorting key, wrapped into monotonic functions, with enable "read in order" optimization (settings optimize_read_in_order and optimize_aggregation_in_order). #41701 (Anton Popov).
  • Fix possible crash in SELECT from Merge table with enabled optimize_monotonous_functions_in_order_by setting. Fixes #41269. #41740 (Nikolai Kochetov).
  • Fixed "Part ... intersects part ..." error that might happen in extremely rare cases if replica was restarted just after detaching some part as broken. #41741 (Alexander Tokmakov).
  • Don't allow to create or alter merge tree tables with column name _row_exists, which is reserved for lightweight delete. Fixed #41716. #41763 (Jianmei Zhang).
  • Fix a bug that CORS headers are missing in some HTTP responses. #41792 (Frank Chen).
  • 22.9 might fail to startup ReplicatedMergeTree table if that table was created by 20.3 or older version and was never altered, it's fixed. Fixes #41742. #41796 (Alexander Tokmakov).
  • When the batch sending fails for some reason, it cannot be automatically recovered, and if it is not processed in time, it will lead to accumulation, and the printed error message will become longer and longer, which will cause the http thread to block. #41813 (zhongyuankai).
  • Fix compact parts with compressed marks setting. Fixes #41783 and #41746. #41823 (alesapin).
  • Old versions of Replicated database don't have a special marker in [Zoo]Keeper. We need to check only whether the node contains come obscure data instead of special mark. #41875 (Nikita Mikhaylov).
  • Fix possible exception in fs cache. #41884 (Kseniia Sumarokova).
  • Fix use_environment_credentials for s3 table function. #41970 (Kseniia Sumarokova).
  • Fixed "Directory already exists and is not empty" error on detaching broken part that might prevent ReplicatedMergeTree table from starting replication. Fixes #40957. #41981 (Alexander Tokmakov).
  • toDateTime64 now returns the same output with negative integer and float arguments. #42025 (Robert Schulze).
  • Fix write into azure_blob_storage. Partially closes #41754. #42034 (Kseniia Sumarokova).
  • Fix the bzip2 decoding issue for specific bzip2 files. #42046 (Nikolay Degterinsky).
  • Fix SQL function toLastDayOfMonth with setting "enable_extended_results_for_datetime_functions = 1" at the beginning of the extended range (January 1900). - Fix SQL function "toRelativeWeekNum()" with setting "enable_extended_results_for_datetime_functions = 1" at the end of extended range (December 2299). - Improve the performance of for SQL functions "toISOYear()", "toFirstDayNumOfISOYearIndex()" and "toYearWeekOfNewyearMode()" by avoiding unnecessary index arithmetics. #42084 (Roman Vasin).
  • The maximum size of fetches for each table accidentally was set to 8 while the pool size could be bigger. Now the maximum size of fetches for table is equal to the pool size. #42090 (Nikita Mikhaylov).
  • A table might be shut down and a dictionary might be detached before checking if can be dropped without breaking dependencies between table, it's fixed. Fixes #41982. #42106 (Alexander Tokmakov).
  • Fix bad inefficiency of remote_filesystem_read_method=read with filesystem cache. Closes #42125. #42129 (Kseniia Sumarokova).
  • Fix possible timeout exception for distributed queries with use_hedged_requests = 0. #42130 (Azat Khuzhin).
  • Fixed a minor bug inside function runningDifference in case of using it with Date32 type. Previously Date was used and it may cause some logical errors like Bad cast from type DB::ColumnVector<int> to DB::ColumnVector<unsigned short>'. #42143 (Alfred Xu).
  • Fix reusing of files > 4GB from base backup. #42146 (Azat Khuzhin).
  • DISTINCT in order fails with LOGICAL_ERROR if first column in sorting key contains function. #42186 (Igor Nikonov).
  • Fix a bug with projections and the aggregate_functions_null_for_empty setting. This bug is very rare and appears only if you enable the aggregate_functions_null_for_empty setting in the server's config. This closes #41647. #42198 (Alexey Milovidov).
  • Fix read from Buffer tables with read in order desc. #42236 (Duc Canh Le).
  • Fix a bug which prevents ClickHouse to start when background_pool_size setting is set on default profile but background_merges_mutations_concurrency_ratio is not. #42315 (nvartolomei).
  • ALTER UPDATE of attached part (with columns different from table schema) could create an invalid columns.txt metadata on disk. Reading from such part could fail with errors or return invalid data. Fixes #42161. #42319 (Nikolai Kochetov).
  • Setting additional_table_filters were not applied to Distributed storage. Fixes #41692. #42322 (Nikolai Kochetov).
  • Fix a data race in query finish/cancel. This closes #42346. #42362 (Alexey Milovidov).
  • This reverts #40217 which introduced a regression in date/time functions. #42367 (Alexey Milovidov).
  • Fix assert cast in join on falsy condition, Close #42380. #42407 (Vladimir C).
  • Fix buffer overflow in the processing of Decimal data types. This closes #42451. #42465 (Alexey Milovidov).
  • AggregateFunctionQuantile now correctly works with UInt128 columns. Previously, the quantile state interpreted UInt128 columns as Int128 which could have led to incorrect results. #42473 (Antonio Andelic).
  • Fix bad_cast assert during INSERT into Annoy indexes over non-Float32 columns. Annoy indices is an experimental feature. #42485 (Robert Schulze).
  • Arithmetic operator with Date or DateTime and 128 or 256-bit integer was referencing uninitialized memory. #42453. #42573 (Alexey Milovidov).
  • Fix unexpected table loading error when partition key contains alias function names during server upgrade. #36379 (Amos Bird).

ClickHouse release 22.9, 2022-09-22​

Backward Incompatible Change​

  • Upgrade from 20.3 and older to 22.9 and newer should be done through an intermediate version if there are any ReplicatedMergeTree tables, otherwise server with the new version will not start. #40641 (Alexander Tokmakov).
  • Remove the functions accurate_Cast and accurate_CastOrNull (they are different to accurateCast and accurateCastOrNull by underscore in the name and they are not affected by the value of cast_keep_nullable setting). These functions were undocumented, untested, unused, and unneeded. They appeared to be alive due to code generalization. #40682 (Alexey Milovidov).
  • Add a test to ensure that every new table function will be documented. See #40649. Rename table function MeiliSearch to meilisearch. #40709 (Alexey Milovidov).
  • Add a test to ensure that every new function will be documented. See #40649. The functions lemmatize, synonyms, stem were case-insensitive by mistake. Now they are case-sensitive. #40711 (Alexey Milovidov).
  • For security and stability reasons, catboost models are no longer evaluated within the ClickHouse server. Instead, the evaluation is now done in the clickhouse-library-bridge, a separate process that loads the catboost library and communicates with the server process via HTTP. #40897 (Robert Schulze).
  • Make interpretation of YAML configs to be more conventional. #41044 (Vitaly Baranov).

New Feature​

  • Support insert_quorum = 'auto' to use majority number. #39970 (Sachin).
  • Add embedded dashboards to ClickHouse server. This is a demo project about how to achieve 90% results with 1% effort using ClickHouse features. #40461 (Alexey Milovidov).
  • Added new settings constraint writability kind changeable_in_readonly. #40631 (Sergei Trifonov).
  • Add support for INTERSECT DISTINCT and EXCEPT DISTINCT. #40792 (Duc Canh Le).
  • Add new input/output format JSONObjectEachRow - Support import for formats JSON/JSONCompact/JSONColumnsWithMetadata. Add new setting input_format_json_validate_types_from_metadata that controls whether we should check if data types from metadata match data types from the header. - Add new setting input_format_json_validate_utf8, when it's enabled, all JSON formats will validate UTF-8 sequences. It will be disabled by default. Note that this setting doesn't influence output formats JSON/JSONCompact/JSONColumnsWithMetadata, they always validate utf8 sequences (this exception was made because of compatibility reasons). - Add new setting input_format_json_read_numbers_as_strings that allows to parse numbers in String column, the setting is disabled by default. - Add new setting output_format_json_quote_decimals that allows to output decimals in double quotes, disabled by default. - Allow to parse decimals in double quotes during data import. #40910 (Kruglov Pavel).
  • Query parameters supported in DESCRIBE TABLE query. #40952 (Nikita Taranov).
  • Add support to Parquet Time32/64 by converting it into DateTime64. Parquet time32/64 represents time elapsed since midnight, while DateTime32/64 represents an actual unix timestamp. Conversion simply offsets from 0. #41333 (Arthur Passos).
  • Implement set operations on Apache Datasketches. #39919 (Fangyuan Deng). Note: there is no point of using Apache Datasketches, they are inferiour than ClickHouse and only make sense for integration with other systems.
  • Allow recording errors to specified file while reading text formats (CSV, TSV). #40516 (zjial).

Experimental Feature​

  • Add ANN (approximate nearest neighbor) index based on Annoy. #40818 (Filatenkov Artur). #37215 (VVMak).
  • Add new storage engine KeeperMap, that uses ClickHouse Keeper or ZooKeeper as a key-value store. #39976 (Antonio Andelic). This storage engine is intended to store a small amount of metadata.
  • Improvement for in-memory data parts: remove completely processed WAL files. #40592 (Azat Khuzhin).

Performance Improvement​

  • Implement compression of marks and primary key. Close #34437. #37693 (zhongyuankai).
  • Allow to load marks with threadpool in advance. Regulated by setting load_marks_asynchronously (default: 0). #40821 (Kseniia Sumarokova).
  • Virtual filesystem over s3 will use random object names split into multiple path prefixes for better performance on AWS. #40968 (Alexey Milovidov).
  • Account max_block_size value while producing single-level aggregation results. Allows to execute following query plan steps using more threads. #39138 (Nikita Taranov).
  • Software prefetching is used in aggregation to speed up operations with hash tables. Controlled by the setting enable_software_prefetch_in_aggregation, enabled by default. #39304 (Nikita Taranov).
  • Better support of optimize_read_in_order in case when some of sorting key columns are always constant after applying WHERE clause. E.g. query like SELECT ... FROM table WHERE a = 'x' ORDER BY a, b, where table has storage definition: MergeTree ORDER BY (a, b). #38715 (Anton Popov).
  • Filter joined streams for full_sorting_join by each other before sorting. #39418 (Vladimir C).
  • LZ4 decompression optimised by skipping empty literals processing. #40142 (Nikita Taranov).
  • Speedup backup process using native copy when possible instead of copying through clickhouse-server memory. #40395 (alesapin).
  • Do not obtain storage snapshot for each INSERT block (slightly improves performance). #40638 (Azat Khuzhin).
  • Implement batch processing for aggregate functions with multiple nullable arguments. #41058 (Raúl Marín).
  • Speed up reading UniquesHashSet (uniqState from disk for example). #41089 (Raúl Marín).
  • Fixed high memory usage while executing mutations of compact parts in tables with huge number of columns. #41122 (lthaooo).
  • Enable the vectorscan library on ARM, this speeds up regexp evaluation. #41033 (Robert Schulze).
  • Upgrade vectorscan to 5.4.8 which has many performance optimizations to speed up regexp evaluation. #41270 (Robert Schulze).
  • Fix incorrect fallback to skip the local filesystem cache for VFS (like S3) which happened on very high concurrency level. #40420 (Kseniia Sumarokova).
  • If row policy filter is always false, return empty result immediately without reading any data. This closes #24012. #40740 (Amos Bird).
  • Parallel hash JOIN for Float data types might be suboptimal. Make it better. #41183 (Alexey Milovidov).

Improvement​

  • During startup and ATTACH call, ReplicatedMergeTree tables will be readonly until the ZooKeeper connection is made and the setup is finished. #40148 (Antonio Andelic).
  • Add enable_extended_results_for_datetime_functions option to return results of type Date32 for functions toStartOfYear, toStartOfISOYear, toStartOfQuarter, toStartOfMonth, toStartOfWeek, toMonday and toLastDayOfMonth when argument is Date32 or DateTime64, otherwise results of Date type are returned. For compatibility reasons default value is ‘0’. #41214 (Roman Vasin).
  • For security and stability reasons, CatBoost models are no longer evaluated within the ClickHouse server. Instead, the evaluation is now done in the clickhouse-library-bridge, a separate process that loads the catboost library and communicates with the server process via HTTP. Function modelEvaluate() was replaced by catboostEvaluate(). #40897 (Robert Schulze). #39629 (Robert Schulze).
  • Add more metrics for on-disk temporary data, close #40206. #40239 (Vladimir C).
  • Add config option warning_supress_regexp, close #40330. #40548 (Vladimir C).
  • Add setting to disable limit on kafka_num_consumers. Closes #40331. #40670 (Kruglov Pavel).
  • Support SETTINGS in DELETE ... query. #41533 (Kseniia Sumarokova).
  • Detailed S3 profile events DiskS3* per S3 API call split for S3 ObjectStorage. #41532 (Sergei Trifonov).
  • Two new metrics in system.asynchronous_metrics. NumberOfDetachedParts and NumberOfDetachedByUserParts. #40779 (Sema Checherinda).
  • Allow CONSTRAINTs for ODBC and JDBC tables. #34551 (Alexey Milovidov).
  • Don't print SETTINGS more than once during query formatting if it didn't appear multiple times in the original query. #38900 (Raúl Marín).
  • Improve the tracing (OpenTelemetry) context propagation across threads. #39010 (Frank Chen).
  • ClickHouse Keeper: add listeners for interserver_listen_host only in Keeper if specified. #39973 (Antonio Andelic).
  • Improve recovery of Replicated user access storage after errors. #39977 (Vitaly Baranov).
  • Add support for TTL in EmbeddedRocksDB. #39986 (Lloyd-Pottiger).
  • Add schema inference to clickhouse-obfuscator, so the --structure argument is no longer required. #40120 (Nikolay Degterinsky).
  • Improve and fix dictionaries in Arrow format. #40173 (Kruglov Pavel).
  • More natural conversion of Date32, DateTime64, Date to narrower types: upper or lower normal value is considered when out of normal range. #40217 (Andrey Zvonov).
  • Fix the case when Merge table over View cannot use index. #40233 (Duc Canh Le).
  • Custom key names for JSON server logs. #40251 (Mallik Hassan).
  • It is now possible to set a custom error code for the exception thrown by function throwIf. #40319 (Robert Schulze).
  • Improve schema inference cache, respect format settings that can change the schema. #40414 (Kruglov Pavel).
  • Allow parsing Date as DateTime and DateTime64. This implements the enhancement proposed in #36949. #40474 (Alexey Milovidov).
  • Allow conversion from String with DateTime64 like 2022-08-22 01:02:03.456 to Date and Date32. Allow conversion from String with DateTime like 2022-08-22 01:02:03 to Date32. This closes #39598. #40475 (Alexey Milovidov).
  • Better support for nested data structures in Parquet format #40485 (Arthur Passos).
  • Support reading Array(Record) into flatten nested table in Avro. #40534 (Kruglov Pavel).
  • Add read-only support for EmbeddedRocksDB. #40543 (Lloyd-Pottiger).
  • Validate the compression method parameter of URL table engine. #40600 (Frank Chen).
  • Better format detection for url table function/engine in presence of a query string after a file name. Closes #40315. #40636 (Kruglov Pavel).
  • Disable projection when grouping set is used. It generated wrong result. This fixes #40635. #40726 (Amos Bird).
  • Fix incorrect format of APPLY column transformer which can break metadata if used in table definition. This fixes #37590. #40727 (Amos Bird).
  • Support the %z descriptor for formatting the timezone offset in formatDateTime. #40736 (Cory Levy).
  • The interactive mode in clickhouse-client now interprets . and / as "run the last command". #40750 (Robert Schulze).
  • Fix issue with passing MySQL timeouts for MySQL database engine and MySQL table function. Closes #34168. #40751 (Kseniia Sumarokova).
  • Create status file for filesystem cache directory to make sure that cache directories are not shared between different servers or caches. #40820 (Kseniia Sumarokova).
  • Add support for DELETE and UPDATE for EmbeddedRocksDB storage. #40853 (Antonio Andelic).
  • ClickHouse Keeper: fix shutdown during long commit and increase allowed request size. #40941 (Antonio Andelic).
  • Fix race in WriteBufferFromS3, add TSA annotations. #40950 (Kseniia Sumarokova).
  • Grouping sets with group_by_use_nulls should only convert key columns to nullable. #40997 (Duc Canh Le).
  • Improve the observability of INSERT on distributed table. #41034 (Frank Chen).
  • More low-level metrics for S3 interaction. #41039 (mateng915).
  • Support relative path in Location header after HTTP redirect. Closes #40985. #41162 (Kruglov Pavel).
  • Apply changes to HTTP handlers on fly without server restart. #41177 (Azat Khuzhin).
  • ClickHouse Keeper: properly close active sessions during shutdown. #41215 (Antonio Andelic). This lowers the period of "table is read-only" errors.
  • Add ability to automatically comment SQL queries in clickhouse-client/local (with Alt-#, like in readline). #41224 (Azat Khuzhin).
  • Fix incompatibility of cache after switching setting do_no_evict_index_and_mark_files from 1 to 0, 0 to 1. #41330 (Kseniia Sumarokova).
  • Add a setting allow_suspicious_fixed_string_types to prevent users from creating columns of type FixedString with size > 256. #41495 (Duc Canh Le).
  • Add has_lightweight_delete to system.parts. #41564 (Kseniia Sumarokova).

Build/Testing/Packaging Improvement​

Bug Fix​

  • Fix potential dataloss due to a bug in AWS SDK. Bug can be triggered only when clickhouse is used over S3. #40506 (alesapin). This bug has been open for 5 years in AWS SDK and is closed after our report.
  • Malicious data in Native format might cause a crash. #41441 (Alexey Milovidov).
  • The aggregate function categorialInformationValue was having incorrectly defined properties, which might cause a null pointer dereferencing at runtime. This closes #41443. #41449 (Alexey Milovidov).
  • Writing data in Apache ORC format might lead to a buffer overrun. #41458 (Alexey Milovidov).
  • Fix memory safety issues with functions encrypt and contingency if Array of Nullable is used as an argument. This fixes #41004. #40195 (Alexey Milovidov).
  • Fix bugs in MergeJoin when 'not_processed' is not null. #40335 (liql2007).
  • Fix incorrect result in case of decimal precision loss in IN operator, ref #41125. #41130 (Vladimir C).
  • Fix filling of missed Nested columns with multiple levels. #37152 (Anton Popov).
  • Fix SYSTEM UNFREEZE query for Ordinary (deprecated) database. Fix for https://github.com/ClickHouse/ClickHouse/pull/36424. #38262 (Vadim Volodin).
  • Fix unused unknown columns introduced by WITH statement. This fixes #37812 . #39131 (Amos Bird).
  • Fix query analysis for ORDER BY in presence of window functions. Fixes #38741 Fixes #24892. #39354 (Dmitry Novik).
  • Fixed Unknown identifier (aggregate-function) exception which appears when a user tries to calculate WINDOW ORDER BY/PARTITION BY expressions over aggregate functions. #39762 (Vladimir Chebotaryov).
  • Limit number of analyze for one query with setting max_analyze_depth. It prevents exponential blow up of analysis time for queries with extraordinarily large number of subqueries. #40334 (Vladimir C).
  • Fix rare bug with column TTL for MergeTree engines family: In case of repeated vertical merge the error Cannot unlink file ColumnName.bin ... No such file or directory. could happen. #40346 (alesapin).
  • Use DNS entries for both IPv4 and IPv6 if present. #40353 (Maksim Kita).
  • Allow to read snappy compressed files from Hadoop. #40482 (Kruglov Pavel).
  • Fix crash while parsing values of type Object (experimental feature) that contains arrays of variadic dimension. #40483 (Duc Canh Le).
  • Fix settings input_format_tsv_skip_first_lines. #40491 (mini4).
  • Fix bug (race condition) when starting up MaterializedPostgreSQL database/table engine. #40262. Fix error with reaching limit of relcache_callback_list slots. #40511 (Maksim Buren).
  • Fix possible error 'Decimal math overflow' while parsing DateTime64. #40546 (Kruglov Pavel).
  • Fix vertical merge of parts with lightweight deleted rows. #40559 (Alexander Gololobov).
  • Fix segment fault when writing data to URL table engine if it enables compression. #40565 (Frank Chen).
  • Fix possible logical error 'Invalid Field get from type UInt64 to type String' in arrayElement function with Map. #40572 (Kruglov Pavel).
  • Fix possible race in filesystem cache. #40586 (Kseniia Sumarokova).
  • Removed skipping of mutations in unaffected partitions of MergeTree tables, because this feature never worked correctly and might cause resurrection of finished mutations. #40589 (Alexander Tokmakov).
  • The clickhouse server will crash if we add a grpc port which has been occupied to the configuration in runtime. #40597 (何李夫).
  • Fix base58Encode / base58Decode handling leading 0 / '1'. #40620 (Andrey Zvonov).
  • keeper-fix: fix race in accessing logs while snapshot is being installed. #40627 (Antonio Andelic).
  • Fix short circuit execution of toFixedString function. Solves (partially) #40622. #40628 (Kruglov Pavel).
  • Fixes SQLite int8 column conversion to int64 column in ClickHouse. Fixes #40639. #40642 (Barum Rho).
  • Fix stack overflow in recursive Buffer tables. This closes #40637. #40643 (Alexey Milovidov).
  • During insertion of a new query to the ProcessList allocations happen. If we reach the memory limit during these allocations we can not use OvercommitTracker, because ProcessList::mutex is already acquired. Fixes #40611. #40677 (Dmitry Novik).
  • Fix LOGICAL_ERROR with max_read_buffer_size=0 during reading marks. #40705 (Azat Khuzhin).
  • Fix memory leak while pushing to MVs w/o query context (from Kafka/...). #40732 (Azat Khuzhin).
  • Fix possible error Attempt to read after eof in CSV schema inference. #40746 (Kruglov Pavel).
  • Fix logical error in write-through cache "File segment completion can be done only by downloader". Closes #40748. #40759 (Kseniia Sumarokova).
  • Make the result of GROUPING function the same as in SQL and other DBMS. #40762 (Dmitry Novik).
  • In #40595 it was reported that the host_regexp functionality was not working properly with a name to address resolution in /etc/hosts. It's fixed. #40769 (Arthur Passos).
  • Fix incremental backups for Log family. #40827 (Vitaly Baranov).
  • Fix extremely rare bug which can lead to potential data loss in zero-copy replication. #40844 (alesapin).
  • Fix key condition analyzing crashes when same set expression built from different column(s). #40850 (Duc Canh Le).
  • Fix nested JSON Objects schema inference. #40851 (Kruglov Pavel).
  • Fix 3-digit prefix directory for filesystem cache files not being deleted if empty. Closes #40797. #40867 (Kseniia Sumarokova).
  • Fix uncaught DNS_ERROR on failed connection to replicas. #40881 (Robert Coelho).
  • Fix bug when removing unneeded columns in subquery. #40884 (luocongkai).
  • Fix extra memory allocation for remote read buffers. #40896 (Kseniia Sumarokova).
  • Fixed a behaviour when user with explicitly revoked grant for dropping databases can still drop it. #40906 (Nikita Mikhaylov).
  • A fix for ClickHouse Keeper: correctly compare paths in write requests to Keeper internal system node paths. #40918 (Antonio Andelic).
  • Fix deadlock in WriteBufferFromS3. #40943 (Kseniia Sumarokova).
  • Fix access rights for DESCRIBE TABLE url() and some other DESCRIBE TABLE <table_function>(). #40975 (Vitaly Baranov).
  • Remove wrong parser logic for WITH GROUPING SETS which may lead to nullptr dereference. #41049 (Duc Canh Le).
  • A fix for ClickHouse Keeper: fix possible segfault during Keeper shutdown. #41075 (Antonio Andelic).
  • Fix possible segfaults, use-heap-after-free and memory leak in aggregate function combinators. Closes #40848. #41083 (Kruglov Pavel).
  • Fix query_views_log with Window views. #41132 (Raúl Marín).
  • Disables optimize_monotonous_functions_in_order_by by default, mitigates: #40094. #41136 (Denny Crane).
  • Fixed "possible deadlock avoided" error on automatic conversion of database engine from Ordinary to Atomic. #41146 (Alexander Tokmakov).
  • Fix SIGSEGV in SortedBlocksWriter in case of empty block (possible to get with optimize_aggregation_in_order and join_algorithm=auto). #41154 (Azat Khuzhin).
  • Fix incorrect query result when trivial count optimization is in effect with array join. This fixes #39431. #41158 (Denny Crane).
  • Fix stack-use-after-return in GetPriorityForLoadBalancing::getPriorityFunc(). #41159 (Azat Khuzhin).
  • Fix positional arguments exception Positional argument out of bounds. Closes #40634. #41189 (Kseniia Sumarokova).
  • Fix background clean up of broken detached parts. #41190 (Kseniia Sumarokova).
  • Fix exponential query rewrite in case of lots of cross joins with where, close #21557. #41223 (Vladimir C).
  • Fix possible logical error in write-through cache, which happened because not all types of exception were handled as needed. Closes #41208. #41232 (Kseniia Sumarokova).
  • Fix String log entry in system.filesystem_cache_log. #41233 (jmimbrero).
  • Queries with OFFSET clause in subquery and WHERE clause in outer query might return incorrect result, it's fixed. Fixes #40416. #41280 (Alexander Tokmakov).
  • Fix possible wrong query result with query_plan_optimize_primary_key enabled. Fixes #40599. #41281 (Nikolai Kochetov).
  • Do not allow invalid sequences influence other rows in lowerUTF8/upperUTF8. #41286 (Azat Khuzhin).
  • Fix ALTER <table> ADD COLUMN queries with columns of type Object. #41290 (Anton Popov).
  • Fixed "No node" error when selecting from system.distributed_ddl_queue when there's no distributed_ddl.path in config. Fixes #41096. #41296 (young scott).
  • Fix incorrect logical error Expected relative path in disk object storage. Related to #41246. #41297 (Kseniia Sumarokova).
  • Add column type check before UUID insertion in MsgPack format. #41309 (Kruglov Pavel).
  • Fix possible crash after inserting asynchronously (with enabled setting async_insert) malformed data to columns of type Object. It could happen, if JSONs in all batches of async inserts were invalid and could not be parsed. #41336 (Anton Popov).
  • Fix possible deadlock with async_socket_for_remote/use_hedged_requests and parallel KILL. #41343 (Azat Khuzhin).
  • Disables optimize_rewrite_sum_if_to_count_if by default, mitigates: #38605 #38683. #41388 (Denny Crane).
  • Since 22.8 ON CLUSTER clause is ignored if database is Replicated and cluster name and database name are the same. Because of this DROP PARTITION ON CLUSTER worked unexpected way with Replicated. It's fixed, now ON CLUSTER clause is ignored only for queries that are replicated on database level. Fixes #41299. #41390 (Alexander Tokmakov).
  • Fix possible hung/deadlock on query cancellation (KILL QUERY or server shutdown). #41467 (Azat Khuzhin).
  • Fix possible server crash when using the JBOD feature. This fixes #41365. #41483 (Amos Bird).
  • Fix conversion from nullable fixed string to string. #41541 (Duc Canh Le).
  • Prevent crash when passing wrong aggregation states to groupBitmap*. #41563 (Raúl Marín).
  • Queries with ORDER BY and 1500 <= LIMIT <= max_block_size could return incorrect result with missing rows from top. Fixes #41182. #41576 (Nikolai Kochetov).
  • Fix read bytes/rows in X-ClickHouse-Summary with materialized views. #41586 (Raúl Marín).
  • Fix possible pipeline stuck exception for queries with OFFSET. The error was found with enable_optimize_predicate_expression = 0 and always false condition in WHERE. Fixes #41383. #41588 (Nikolai Kochetov).

ClickHouse release 22.8, 2022-08-18​

Backward Incompatible Change​

  • Extended range of Date32 and DateTime64 to support dates from the year 1900 to 2299. In previous versions, the supported interval was only from the year 1925 to 2283. The implementation is using the proleptic Gregorian calendar (which is conformant with ISO 8601:2004 (clause 3.2.1 The Gregorian calendar)) instead of accounting for historical transitions from the Julian to the Gregorian calendar. This change affects implementation-specific behavior for out-of-range arguments. E.g. if in previous versions the value of 1899-01-01 was clamped to 1925-01-01, in the new version it will be clamped to 1900-01-01. It changes the behavior of rounding with toStartOfInterval if you pass INTERVAL 3 QUARTER up to one quarter because the intervals are counted from an implementation-specific point of time. Closes #28216, improves #38393. #39425 (Roman Vasin).
  • Now, all relevant dictionary sources respect remote_url_allow_hosts setting. It was already done for HTTP, Cassandra, Redis. Added ClickHouse, MongoDB, MySQL, PostgreSQL. Host is checked only for dictionaries created from DDL. #39184 (Nikolai Kochetov).
  • Prebuilt ClickHouse x86 binaries now require support for AVX instructions, i.e. a CPU not older than Intel Sandy Bridge / AMD Bulldozer, both released in 2011. #39000 (Robert Schulze).
  • Make the remote filesystem cache composable, allow not to evict certain files (regarding idx, mrk, ..), delete old cache version. Now it is possible to configure cache over Azure blob storage disk, over Local disk, over StaticWeb disk, etc. This PR is marked backward incompatible because cache configuration changes and in order for cache to work need to update the config file. Old cache will still be used with new configuration. The server will startup fine with the old cache configuration. Closes https://github.com/ClickHouse/ClickHouse/issues/36140. Closes https://github.com/ClickHouse/ClickHouse/issues/37889. (Kseniia Sumarokova). #36171)

New Feature​

  • Support SQL standard DELETE FROM syntax on merge tree tables and lightweight delete implementation for merge tree families. #37893 (Jianmei Zhang) (Alexander Gololobov). Note: this new feature does not make ClickHouse an HTAP DBMS.
  • Query parameters can be set in interactive mode as SET param_abc = 'def' and transferred via the native protocol as settings. #39906 (Nikita Taranov).
  • Quota key can be set in the native protocol (Yakov Olkhovsky).
  • Added a setting exact_rows_before_limit (0/1). When enabled, ClickHouse will provide exact value for rows_before_limit_at_least statistic, but with the cost that the data before limit will have to be read completely. This closes #6613. #25333 (kevin wan).
  • Added support for parallel distributed insert select with s3Cluster table function into tables with Distributed and Replicated engine #34670. #39107 (Nikita Mikhaylov).
  • Add new settings to control schema inference from text formats: - input_format_try_infer_dates - try infer dates from strings. - input_format_try_infer_datetimes - try infer datetimes from strings. - input_format_try_infer_integers - try infer Int64 instead of Float64. - input_format_json_try_infer_numbers_from_strings - try infer numbers from json strings in JSON formats. #39186 (Kruglov Pavel).
  • An option to provide JSON formatted log output. The purpose is to allow easier ingestion and query in log analysis tools. #39277 (Mallik Hassan).
  • Add function nowInBlock which allows getting the current time during long-running and continuous queries. Closes #39522. Notes: there are no functions now64InBlock neither todayInBlock. #39533 (Alexey Milovidov).
  • Add ability to specify settings for an executable() table function. #39681 (Constantine Peresypkin).
  • Implemented automatic conversion of database engine from Ordinary to Atomic. Create empty convert_ordinary_to_atomic file in flags directory and all Ordinary databases will be converted automatically on next server start. Resolves #39546. #39933 (Alexander Tokmakov).
  • Support SELECT ... INTO OUTFILE '...' AND STDOUT. #37490. #39054 (SmitaRKulkarni).
  • Add formats PrettyMonoBlock, PrettyNoEscapesMonoBlock, PrettyCompactNoEscapes, PrettyCompactNoEscapesMonoBlock, PrettySpaceNoEscapes, PrettySpaceMonoBlock, PrettySpaceNoEscapesMonoBlock. #39646 (Kruglov Pavel).

Performance Improvement​

  • Improved memory usage during memory efficient merging of aggregation results. #39429 (Nikita Taranov).
  • Added concurrency control logic to limit total number of concurrent threads created by queries. #37558 (Sergei Trifonov). Add concurrent_threads_soft_limit parameter to increase performance in case of high QPS by means of limiting total number of threads for all queries. #37285 (Roman Vasin).
  • Add SLRU cache policy for uncompressed cache and marks cache. (Kseniia Sumarokova). #34651 (alexX512). Decoupling local cache function and cache algorithm #38048 (Han Shukai).
  • Intel® In-Memory Analytics Accelerator (Intel® IAA) is a hardware accelerator available in the upcoming generation of Intel® Xeon® Scalable processors ("Sapphire Rapids"). Its goal is to speed up common operations in analytics like data (de)compression and filtering. ClickHouse gained the new "DeflateQpl" compression codec which utilizes the Intel® IAA offloading technology to provide a high-performance DEFLATE implementation. The codec uses the Intel® Query Processing Library (QPL) which abstracts access to the hardware accelerator, respectively to a software fallback in case the hardware accelerator is not available. DEFLATE provides in general higher compression rates than ClickHouse's LZ4 default codec, and as a result, offers less disk I/O and lower main memory consumption. #36654 (jasperzhu). #39494 (Robert Schulze).
  • DISTINCT in order with ORDER BY: Deduce way to sort based on input stream sort description. Skip sorting if input stream is already sorted. #38719 (Igor Nikonov). Improve memory usage (significantly) and query execution time + use DistinctSortedChunkTransform for final distinct when DISTINCT columns match ORDER BY columns, but rename to DistinctSortedStreamTransform in EXPLAIN PIPELINE → this improves memory usage significantly + remove unnecessary allocations in hot loop in DistinctSortedChunkTransform. #39432 (Igor Nikonov). Use DistinctSortedTransform only when sort description is applicable to DISTINCT columns, otherwise fall back to ordinary DISTINCT implementation + it allows making less checks during DistinctSortedTransform execution. #39528 (Igor Nikonov). Fix: DistinctSortedTransform didn't take advantage of sorting. It never cleared HashSet since clearing_columns were detected incorrectly (always empty). So, it basically worked as ordinary DISTINCT (DistinctTransform). The fix reduces memory usage significantly. #39538 (Igor Nikonov).
  • Use local node as first priority to get structure of remote table when executing cluster and similar table functions. #39440 (Mingliang Pan).
  • Optimize filtering by numeric columns with AVX512VBMI2 compress store. #39633 (Guo Wangyang). For systems with AVX512 VBMI2, this PR improves performance by ca. 6% for SSB benchmark queries queries 3.1, 3.2 and 3.3 (SF=100). Tested on Intel Icelake Xeon 8380 * 2 socket. #40033 (Robert Schulze).
  • Optimize index analysis with functional expressions in multi-thread scenario. #39812 (Guo Wangyang).
  • Optimizations for complex queries: Don't visit the AST for UDFs if none are registered. #40069 (Raúl Marín). Optimize CurrentMemoryTracker alloc and free. #40078 (Raúl Marín).
  • Improved Base58 encoding/decoding. #39292 (Andrey Zvonov).
  • Improve bytes to bits mask transform for SSE/AVX/AVX512. #39586 (Guo Wangyang).

Improvement​

  • Normalize AggregateFunction types and state representations because optimizations like #35788 will treat count(not null columns) as count(), which might confuses distributed interpreters with the following error : Conversion from AggregateFunction(count) to AggregateFunction(count, Int64) is not supported. #39420 (Amos Bird). The functions with identical states can be used in materialized views interchangeably.
  • Rework and simplify the system.backups table, remove the internal column, allow user to set the ID of operation, add columns num_files, uncompressed_size, compressed_size, start_time, end_time. #39503 (Vitaly Baranov).
  • Improved structure of DDL query result table for Replicated database (separate columns with shard and replica name, more clear status) - CREATE TABLE ... ON CLUSTER queries can be normalized on initiator first if distributed_ddl_entry_format_version is set to 3 (default value). It means that ON CLUSTER queries may not work if initiator does not belong to the cluster that specified in query. Fixes #37318, #39500 - Ignore ON CLUSTER clause if database is Replicated and cluster name equals to database name. Related to #35570 - Miscellaneous minor fixes for Replicated database engine - Check metadata consistency when starting up Replicated database, start replica recovery in case of mismatch of local metadata and metadata in Keeper. Resolves #24880. #37198 (Alexander Tokmakov).
  • Add result_rows and result_bytes to progress reports (X-ClickHouse-Summary). #39567 (Raúl Marín).
  • Improve primary key analysis for MergeTree. #25563 (Nikolai Kochetov).
  • timeSlots now works with DateTime64; subsecond duration and slot size available when working with DateTime64. #37951 (Andrey Zvonov).
  • Added support of LEFT SEMI and LEFT ANTI direct join with EmbeddedRocksDB tables. #38956 (Vladimir C).
  • Add profile events for fsync operations. #39179 (Azat Khuzhin).
  • Add the second argument to the ordinary function file(path[, default]), which function returns in the case when a file does not exists. #39218 (Nikolay Degterinsky).
  • Some small fixes for reading via http, allow to retry partial content in case if 200 OK. #39244 (Kseniia Sumarokova).
  • Support queries CREATE TEMPORARY TABLE ... (<list of columns>) AS .... #39462 (Kruglov Pavel).
  • Add support of !/* (exclamation/asterisk) in custom TLDs (cutToFirstSignificantSubdomainCustom()/cutToFirstSignificantSubdomainCustomWithWWW()/firstSignificantSubdomainCustom()). #39496 (Azat Khuzhin).
  • Add support for TLS connections to NATS. Implements #39525. #39527 (Constantine Peresypkin).
  • clickhouse-obfuscator (a tool for database obfuscation for testing and load generation) now has the new --save and --load parameters to work with pre-trained models. This closes #39534. #39541 (Alexey Milovidov).
  • Fix incorrect behavior of log rotation during restart. #39558 (Nikolay Degterinsky).
  • Fix building aggregate projections when external aggregation is on. Mark as improvement because the case is rare and there exists easy workaround to fix it via changing settings. This fixes #39667 . #39671 (Amos Bird).
  • Allow to execute hash functions with arguments of type Map. #39685 (Anton Popov).
  • Add a configuration parameter to hide addresses in stack traces. It may improve security a little but generally, it is harmful and should not be used. #39690 (Alexey Milovidov).
  • Change the prefix size of AggregateFunctionDistinct to make sure nested function data memory segment is aligned. #39696 (Pxl).
  • Properly escape credentials passed to the clickhouse-diagnostic tool. #39707 (Dale McDiarmid).
  • ClickHouse Keeper improvement: create a snapshot on exit. It can be controlled with the config keeper_server.create_snapshot_on_exit, true by default. #39755 (Antonio Andelic).
  • Support primary key analysis for row_policy_filter and additional_filter. It also helps fix issues like #37454 . #39826 (Amos Bird).
  • Fix two usability issues in Play UI: - it was non-pixel-perfect on iPad due to parasitic border radius and margins; - the progress indication did not display after the first query. This closes #39957. This closes #39960. #39961 (Alexey Milovidov).
  • Play UI: add row numbers; add cell selection on click; add hysteresis for table cells. #39962 (Alexey Milovidov).
  • Play UI: recognize tab key in textarea, but at the same time don't mess up with tab navigation. #40053 (Alexey Milovidov).
  • The client will show server-side elapsed time. This is important for the performance comparison of ClickHouse services in remote datacenters. This closes #38070. See also this for motivation. #39968 (Alexey Milovidov).
  • Adds parseDateTime64BestEffortUS, parseDateTime64BestEffortUSOrNull, parseDateTime64BestEffortUSOrZero functions, closing #37492. #40015 (Tanya Bragin).
  • Extend the system.processors_profile_log with more information such as input rows. #40121 (Amos Bird).
  • Display server-side time in clickhouse-benchmark by default if it is available (since ClickHouse version 22.8). This is needed to correctly compare the performance of clouds. This behavior can be changed with the new --client-side-time command line option. Change the --randomize command line option from --randomize 1 to the form without argument. #40193 (Alexey Milovidov).
  • Add counters (ProfileEvents) for cases when query complexity limitation has been set and has reached (a separate counter for overflow_mode = break and throw). For example, if you have set up max_rows_to_read with read_overflow_mode = 'break', looking at the value of OverflowBreak counter will allow distinguishing incomplete results. #40205 (Alexey Milovidov).
  • Fix memory accounting in case of "Memory limit exceeded" errors (previously [peak] memory usage was takes failed allocations into account). #40249 (Azat Khuzhin).
  • Add metrics for filesystem cache: FilesystemCacheSize and FilesystemCacheElements. #40260 (Kseniia Sumarokova).
  • Support hadoop secure RPC transfer (hadoop.rpc.protection=privacy and hadoop.rpc.protection=integrity). #39411 (michael1589).
  • Avoid continuously growing memory consumption of pattern cache when using functions multi(Fuzzy)Match(Any|AllIndices|AnyIndex)(). #40264 (Robert Schulze).

Build/Testing/Packaging Improvement​

Bug Fix​

  • Fix possible segfault in CapnProto input format. This bug was found and send through ClickHouse bug-bounty program by kiojj. #40241 (Kruglov Pavel).
  • Fix a very rare case of incorrect behavior of array subscript operator. This closes #28720. #40185 (Alexey Milovidov).
  • Fix insufficient argument check for encryption functions (found by query fuzzer). This closes #39987. #40194 (Alexey Milovidov).
  • Fix the case when the order of columns can be incorrect if the IN operator is used with a table with ENGINE = Set containing multiple columns. This fixes #13014. #40225 (Alexey Milovidov).
  • Fix seeking while reading from encrypted disk. This PR fixes #38381. #39687 (Vitaly Baranov).
  • Fix duplicate columns in join plan. Finally, solve #26809. #40009 (Vladimir C).
  • Fixed query hanging for SELECT with ORDER BY WITH FILL with different date/time types. #37849 (Yakov Olkhovskiy).
  • Fix ORDER BY that matches projections ORDER BY (before it simply returns unsorted result). #38725 (Azat Khuzhin).
  • Do not optimise functions in GROUP BY statements if they shadow one of the table columns or expressions. Fixes #37032. #39103 (Anton Kozlov).
  • Fix wrong table name in logs after RENAME TABLE. This fixes #38018. #39227 (Amos Bird).
  • Fix positional arguments in case of columns pruning when optimising the query. Closes #38433. #39293 (Kseniia Sumarokova).
  • Fix bug in schema inference in case of empty messages in Protobuf/CapnProto formats that allowed to create column with empty Tuple type. Closes #39051 Add 2 new settings input_format_{protobuf/capnproto}_skip_fields_with_unsupported_types_in_schema_inference that allow to skip fields with unsupported types while schema inference for Protobuf and CapnProto formats. #39357 (Kruglov Pavel).
  • (Window View is an experimental feature) Fix segmentation fault on CREATE WINDOW VIEW .. ON CLUSTER ... INNER. Closes #39363. #39384 (Kseniia Sumarokova).
  • Fix WriteBuffer finalize when cancelling insert into function (in previous versions it may leat to std::terminate). #39458 (Kruglov Pavel).
  • Fix storing of columns of type Object in sparse serialization. #39464 (Anton Popov).
  • Fix possible "Not found column in block" exception when using projections. This closes #39469. #39470 (小路).
  • Fix exception on race between DROP and INSERT with materialized views. #39477 (Azat Khuzhin).
  • A bug in Apache Avro library: fix data race and possible heap-buffer-overflow in Avro format. Closes #39094 Closes #33652. #39498 (Kruglov Pavel).
  • Fix rare bug in asynchronous reading (with setting local_filesystem_read_method='pread_threadpool') with enabled O_DIRECT (enabled by setting min_bytes_to_use_direct_io). #39506 (Anton Popov).
  • (only on FreeBSD) Fixes "Code: 49. DB::Exception: FunctionFactory: the function name '' is not unique. (LOGICAL_ERROR)" observed on FreeBSD when starting clickhouse. #39551 (Alexander Gololobov).
  • Fix bug with the recently introduced "maxsplit" argument for splitByChar, which was not working correctly. #39552 (filimonov).
  • Fix bug in ASOF JOIN with enable_optimize_predicate_expression, close #37813. #39556 (Vladimir C).
  • Fixed CREATE/DROP INDEX query with ON CLUSTER or Replicated database and ReplicatedMergeTree. It used to be executed on all replicas (causing error or DDL queue stuck). Fixes #39511. #39565 (Alexander Tokmakov).
  • Fix "column not found" error for push down with join, close #39505. #39575 (Vladimir C).
  • Fix the wrong REGEXP_REPLACE alias. This fixes https://github.com/ClickHouse/ClickBench/issues/9. #39592 (Alexey Milovidov).
  • Fixed point of origin for exponential decay window functions to the last value in window. Previously, decay was calculated by formula exp((t - curr_row_t) / decay_length), which is incorrect when right boundary of window is not CURRENT ROW. It was changed to: exp((t - last_row_t) / decay_length). There is no change in results for windows with ROWS BETWEEN (smth) AND CURRENT ROW. #39593 (Vladimir Chebotaryov).
  • Fix Decimal division overflow, which can be detected based on operands scale. #39600 (Andrey Zvonov).
  • Fix settings output_format_arrow_string_as_string and output_format_arrow_low_cardinality_as_dictionary work in combination. Closes #39624. #39647 (Kruglov Pavel).
  • Fixed a bug in default database resolution in distributed table reads. #39674 (Anton Kozlov).
  • (Only with the obsolete Ordinary databases) Select might read data of dropped table if cache for mmap IO is used and database engine is Ordinary and new tables was created with the same name as dropped one had. It's fixed. #39708 (Alexander Tokmakov).
  • Fix possible error Invalid column type for ColumnUnique::insertRangeFrom. Expected String, got ColumnLowCardinality Fixes #38460. #39716 (Arthur Passos).
  • Field names in the meta section of JSON format were erroneously double escaped. This closes #39693. #39747 (Alexey Milovidov).
  • Fix wrong index analysis with tuples and operator IN, which could lead to wrong query result. #39752 (Anton Popov).
  • Fix EmbeddedRocksDB tables filtering by key using params. #39757 (Antonio Andelic).
  • Fix error Invalid number of columns in chunk pushed to OutputPort which was caused by ARRAY JOIN optimization. Fixes #39164. #39799 (Nikolai Kochetov).
  • A workaround for a bug in Linux kernel. Fix CANNOT_READ_ALL_DATA exception with local_filesystem_read_method=pread_threadpool. This bug affected only Linux kernel version 5.9 and 5.10 according to man. #39800 (Anton Popov).
  • (Only on NFS) Fix broken NFS mkdir for root-squashed volumes. #39898 (Constantine Peresypkin).
  • Remove dictionaries from prometheus metrics on DETACH/DROP. #39926 (Azat Khuzhin).
  • Fix read of StorageFile with virtual columns. Closes #39907. #39943 (flynn).
  • Fix big memory usage during fetches. Fixes #39915. #39990 (Nikolai Kochetov).
  • (experimental feature) Fix hashId crash and salt parameter not being used. #40002 (Raúl Marín).
  • EXCEPT and INTERSECT operators may lead to crash if a specific combination of constant and non-constant columns were used. #40020 (Duc Canh Le).
  • Fixed "Part directory doesn't exist" and "tmp_<part_name> ... No such file or directory" errors during too slow INSERT or too long merge/mutation. Also fixed issue that may cause some replication queue entries to stuck without any errors or warnings in logs if previous attempt to fetch part failed, but tmp-fetch_<part_name> directory was not cleaned up. #40031 (Alexander Tokmakov).
  • Fix rare cases of parsing of arrays of tuples in format Values. #40034 (Anton Popov).
  • Fixes ArrowColumn format Dictionary(X) & Dictionary(Nullable(X)) conversion to ClickHouse LowCardinality(X) & LowCardinality(Nullable(X)) respectively. #40037 (Arthur Passos).
  • Fix potential deadlock in writing to S3 during task scheduling failure. #40070 (Maksim Kita).
  • Fix bug in collectFilesToSkip() by adding correct file extension (.idx or idx2) for indexes to be recalculated, avoid wrong hard links. Fixed #39896. #40095 (Jianmei Zhang).
  • A fix for reverse DNS resolution. #40134 (Arthur Passos).
  • Fix unexpected result arrayDifference of `Array(UInt32). #40211 (Duc Canh Le).

ClickHouse release 22.7, 2022-07-21​

Upgrade Notes​

  • Enable setting enable_positional_arguments by default. It allows queries like SELECT ... ORDER BY 1, 2 where 1, 2 are the references to the select clause. If you need to return the old behavior, disable this setting. #38204 (Alexey Milovidov).
  • Disable format_csv_allow_single_quotes by default. See #37096. (Kruglov Pavel).
  • Ordinary database engine and old storage definition syntax for *MergeTree tables are deprecated. By default it's not possible to create new databases with Ordinary engine. If system database has Ordinary engine it will be automatically converted to Atomic on server startup. There are settings to keep old behavior (allow_deprecated_database_ordinary and allow_deprecated_syntax_for_merge_tree), but these settings may be removed in future releases. #38335 (Alexander Tokmakov).
  • Force rewriting comma join to inner by default (set default value cross_to_inner_join_rewrite = 2). To have old behavior set cross_to_inner_join_rewrite = 1. #39326 (Vladimir C). If you will face any incompatibilities, you can turn this setting back.

New Feature​

  • Support expressions with window functions. Closes #19857. #37848 (Dmitry Novik).
  • Add new direct join algorithm for EmbeddedRocksDB tables, see #33582. #35363 (Vladimir C).
  • Added full sorting merge join algorithm. #35796 (Vladimir C).
  • Implement NATS table engine, which allows to pub/sub to NATS. Closes #32388. #37171 (tchepavel). (Kseniia Sumarokova)
  • Implement table function mongodb. Allow writes into MongoDB storage / table function. #37213 (aaapetrenko). (Kseniia Sumarokova)
  • Add SQLInsert output format. Closes #38441. #38477 (Kruglov Pavel).
  • Introduced settings additional_table_filters. Using this setting, you can specify additional filtering condition for a table which will be applied directly after reading. Example: select number, x, y from (select number from system.numbers limit 5) f any left join (select x, y from table_1) s on f.number = s.x settings additional_table_filters={'system.numbers : 'number != 3', 'table_1' : 'x != 2'}. Introduced setting additional_result_filter which specifies additional filtering condition for query result. Closes #37918. #38475 (Nikolai Kochetov).
  • Add compatibility setting and system.settings_changes system table that contains information about changes in settings through ClickHouse versions. Closes #35972. #38957 (Kruglov Pavel).
  • Add functions translate(string, from_string, to_string) and translateUTF8(string, from_string, to_string). It translates some characters to another. #38935 (Nikolay Degterinsky).
  • Support parseTimeDelta function. It can be used like ;-+,: can be used as separators, eg. 1yr-2mo, 2m:6s: SELECT parseTimeDelta('1yr-2mo-4w + 12 days, 3 hours : 1 minute ; 33 seconds'). #39071 (jiahui-97).
  • Added CREATE TABLE ... EMPTY AS SELECT query. It automatically deduces table structure from the SELECT query, but does not fill the table after creation. Resolves #38049. #38272 (Alexander Tokmakov).
  • Added options to limit IO operations with remote storage: max_remote_read_network_bandwidth_for_server and max_remote_write_network_bandwidth_for_server. #39095 (Sergei Trifonov).
  • Add group_by_use_nulls setting to make aggregation key columns nullable in the case of ROLLUP, CUBE and GROUPING SETS. Closes #37359. #38642 (Dmitry Novik).
  • Add the ability to specify compression level during data export. #38907 (Nikolay Degterinsky).
  • Add an option to require explicit grants to SELECT from the system database. Details: #38970 (Vitaly Baranov).
  • Functions multiMatchAny, multiMatchAnyIndex, multiMatchAllIndices and their fuzzy variants now accept non-const pattern array argument. #38485 (Robert Schulze). SQL function multiSearchAllPositions now accepts non-const needle arguments. #39167 (Robert Schulze).
  • Add a setting zstd_window_log_max to configure max memory usage on zstd decoding when importing external files. Closes #35693. #37015 (wuxiaobai24).
  • Add send_logs_source_regexp setting. Send server text logs with specified regexp to match log source name. Empty means all sources. #39161 (Amos Bird).
  • Support ALTER for Hive tables. #38214 (lgbo).
  • Support isNullable function. This function checks whether it's argument is nullable and return 1 or 0. Closes #38611. #38841 (lokax).
  • Added functions for base58 encoding/decoding. #38159 (Andrey Zvonov).
  • Add chart visualization to Play UI. #38197 (Alexey Milovidov).
  • Added L2 Squared distance and norm functions for both arrays and tuples. #38545 (Julian Gilyadov).
  • Add ability to pass HTTP headers to the url table function / storage via SQL. Closes #37897. #38176 (Kseniia Sumarokova).
  • Add clickhouse-diagnostics binary to the packages. #38647 (Mikhail f. Shiryaev).

Experimental Feature​

  • Adds new setting implicit_transaction to run standalone queries inside a transaction. It handles both creation and closing (via COMMIT if the query succeeded or ROLLBACK if it didn't) of the transaction automatically. #38344 (Raúl Marín).

Performance Improvement​

  • Distinct optimization for sorted columns. Use specialized distinct transformation in case input stream is sorted by column(s) in distinct. Optimization can be applied to pre-distinct, final distinct, or both. Initial implementation by @dimarub2000. #37803 (Igor Nikonov).
  • Improve performance of ORDER BY, MergeTree merges, window functions using batch version of BinaryHeap. #38022 (Maksim Kita).
  • More parallel execution for queries with FINAL #36396 (Nikita Taranov).
  • Fix significant join performance regression which was introduced in #35616. It's interesting that common join queries such as ssb queries have been 10 times slower for almost 3 months while no one complains. #38052 (Amos Bird).
  • Migrate from the Intel hyperscan library to vectorscan, this speeds up many string matching on non-x86 platforms. #38171 (Robert Schulze).
  • Increased parallelism of query plan steps executed after aggregation. #38295 (Nikita Taranov).
  • Improve performance of insertion to columns of type JSON. #38320 (Anton Popov).
  • Optimized insertion and lookups in the HashTable. #38413 (Nikita Taranov).
  • Fix performance degradation from #32493. #38417 (Alexey Milovidov).
  • Improve performance of joining with numeric columns using SIMD instructions. #37235 (zzachimed). #38565 (Maksim Kita).
  • Norm and Distance functions for arrays speed up 1.2-2 times. #38740 (Alexander Gololobov).
  • Add AVX-512 VBMI optimized copyOverlap32Shuffle for LZ4 decompression. In other words, LZ4 decompression performance is improved. #37891 (Guo Wangyang).
  • ORDER BY (a, b) will use all the same benefits as ORDER BY a, b. #38873 (Igor Nikonov).
  • Align branches within a 32B boundary to make benchmark more stable. #38988 (Guo Wangyang). It improves performance 1..2% on average for Intel.
  • Executable UDF, executable dictionaries, and Executable tables will avoid wasting one second during wait for subprocess termination. #38929 (Constantine Peresypkin).
  • Optimize accesses to system.stack_trace table if not all columns are selected. #39177 (Azat Khuzhin).
  • Improve isNullable/isConstant/isNull/isNotNull performance for LowCardinality argument. #39192 (Kruglov Pavel).
  • Optimized processing of ORDER BY in window functions. #34632 (Vladimir Chebotarev).
  • The table system.asynchronous_metric_log is further optimized for storage space. This closes #38134. See the YouTube video. #38428 (Alexey Milovidov).

Improvement​

  • Support SQL standard CREATE INDEX and DROP INDEX syntax. #35166 (Jianmei Zhang).
  • Send profile events for INSERT queries (previously only SELECT was supported). #37391 (Azat Khuzhin).
  • Implement in order aggregation (optimize_aggregation_in_order) for fully materialized projections. #37469 (Azat Khuzhin).
  • Remove subprocess run for kerberos initialization. Added new integration test. Closes #27651. #38105 (Roman Vasin).
    • Add setting multiple_joins_try_to_keep_original_names to not rewrite identifier name on multiple JOINs rewrite, close #34697. #38149 (Vladimir C).
  • Improved trace-visualizer UX. #38169 (Sergei Trifonov).
  • Enable stack trace collection and query profiler for AArch64. #38181 (Maksim Kita).
  • Do not skip symlinks in user_defined directory during SQL user defined functions loading. Closes #38042. #38184 (Maksim Kita).
  • Added background cleanup of subdirectories in store/. In some cases clickhouse-server might left garbage subdirectories in store/ (for example, on unsuccessful table creation) and those dirs were never been removed. Fixes #33710. #38265 (Alexander Tokmakov).
  • Add DESCRIBE CACHE query to show cache settings from config. Add SHOW CACHES query to show available filesystem caches list. #38279 (Kseniia Sumarokova).
  • Add access check for system drop filesystem cache. Support ON CLUSTER. #38319 (Kseniia Sumarokova).
  • Fix PostgreSQL database engine incompatibility on upgrade from 21.3 to 22.3. Closes #36659. #38369 (Kseniia Sumarokova).
  • filesystemAvailable and similar functions now work in clickhouse-local. This closes #38423. #38424 (Alexey Milovidov).
  • Add revision function. #38555 (Azat Khuzhin).
  • Fix GCS via proxy tunnel usage. #38726 (Azat Khuzhin).
  • Support \i file in clickhouse client / local (similar to psql \i). #38813 (Kseniia Sumarokova).
  • New option optimize = 1 in EXPLAIN AST. If enabled, it shows AST after it's rewritten, otherwise AST of original query. Disabled by default. #38910 (Igor Nikonov).
  • Allow trailing comma in columns list. closes #38425. #38440 (chen).
  • Bugfixes and performance improvements for parallel_hash JOIN method. #37648 (Vladimir C).
  • Support hadoop secure RPC transfer (hadoop.rpc.protection=privacy and hadoop.rpc.protection=integrity). #37852 (Peng Liu).
  • Add struct type support in StorageHive. #38118 (lgbo).
  • S3 single objects are now removed with RemoveObjectRequest. Implement compatibility with GCP which did not allow to use removeFileIfExists effectively breaking approximately half of remove functionality. Automatic detection for DeleteObjects S3 API, that is not supported by GCS. This will allow to use GCS without explicit support_batch_delete=0 in configuration. #37882 (Vladimir Chebotarev).
  • Expose basic ClickHouse Keeper related monitoring data (via ProfileEvents and CurrentMetrics). #38072 (lingpeng0314).
  • Support auto_close option for PostgreSQL engine connection. Closes #31486. #38363 (Kseniia Sumarokova).
  • Allow NULL modifier in columns declaration for table functions. #38816 (Kruglov Pavel).
  • Deactivate mutations_finalizing_task before shutdown to avoid benign TABLE_IS_READ_ONLY errors during shutdown. #38851 (Raúl Marín).
  • Eliminate unnecessary waiting of SELECT queries after ALTER queries in presence of INSERT queries if you use deprecated Ordinary databases. #38864 (Azat Khuzhin).
  • New option rewrite in EXPLAIN AST. If enabled, it shows AST after it's rewritten, otherwise AST of original query. Disabled by default. #38910 (Igor Nikonov).
  • Stop reporting Zookeeper "Node exists" exceptions in system.errors when they are expected. #38961 (Raúl Marín).
  • clickhouse-keeper: add support for real-time digest calculation and verification. It is disabled by default. #37555 (Antonio Andelic).
  • Allow to specify globs * or {expr1, expr2, expr3} inside a key for clickhouse-extract-from-config tool. #38966 (Nikita Mikhaylov).
  • clearOldLogs: Don't report KEEPER_EXCEPTION on concurrent deletes. #39016 (Raúl Marín).
  • clickhouse-keeper improvement: persist meta-information about keeper servers to disk. #39069 (Antonio Andelic). This will make it easier to operate if you shutdown or restart all keeper nodes at the same time.
  • Continue without exception when running out of disk space when using filesystem cache. #39106 (Kseniia Sumarokova).
  • Handling SIGTERM signals from k8s. #39130 (Timur Solodovnikov).
  • Add merge_algorithm column (Undecided, Horizontal, Vertical) to system.part_log. #39181 (Azat Khuzhin).
  • Don't increment a counter in system.errors when the disk is not rotational. #39216 (Raúl Marín).
  • The metric result_bytes for INSERT queries in system.query_log shows number of bytes inserted. Previously value was incorrect and stored the same value as result_rows. #39225 (Ilya Yatsishin).
  • The CPU usage metric in clickhouse-client will be displayed in a better way. Fixes #38756. #39280 (Sergei Trifonov).
  • Rethrow exception on filesystem cache initialization on server startup, better error message. #39386 (Kseniia Sumarokova).
  • OpenTelemetry now collects traces without Processors spans by default (there are too many). To enable Processors spans collection opentelemetry_trace_processors setting. #39170 (Ilya Yatsishin).
  • Functions multiMatch[Fuzzy](AllIndices/Any/AnyIndex) - don't throw a logical error if the needle argument is empty. #39012 (Robert Schulze).
  • Allow to declare RabbitMQ queue without default arguments x-max-length and x-overflow. #39259 (rnbondarenko).

Build/Testing/Packaging Improvement​

Bug Fix (user-visible misbehavior in official stable or prestable release)​

  • Fix rounding for Decimal128/Decimal256 with more than 19-digits long scale. #38027 (Igor Nikonov).
  • Fixed crash caused by data race in storage Hive (integration table engine). #38887 (lgbo).
  • Fix crash when executing GRANT ALL ON . with ON CLUSTER. It was broken in https://github.com/ClickHouse/ClickHouse/pull/35767. This closes #38618. #38674 (Vitaly Baranov).
  • Correct glob expansion in case of {0..10} forms. Fixes #38498 Current Implementation is similar to what shell does mentiond by @rschu1ze here. #38502 (Heena Bansal).
  • Fix crash for mapUpdate, mapFilter functions when using with constant map argument. Closes #38547. #38553 (hexiaoting).
  • Fix toHour monotonicity information for query optimization which can lead to incorrect query result (incorrect index analysis). This fixes #38333. #38675 (Amos Bird).
  • Fix checking whether s3 storage support parallel writes. It resulted in s3 parallel writes not working. #38792 (chen).
  • Fix s3 seekable reads with parallel read buffer. (Affected memory usage during query). Closes #38258. #38802 (Kseniia Sumarokova).
  • Update simdjson. This fixes #38621 - a buffer overflow on machines with the latest Intel CPUs with AVX-512 VBMI. #38838 (Alexey Milovidov).
  • Fix possible logical error for Vertical merges. #38859 (Maksim Kita).
  • Fix settings profile with seconds unit. #38896 (Raúl Marín).
  • Fix incorrect partition pruning when there is a nullable partition key. Note: most likely you don't use nullable partition keys - this is an obscure feature you should not use. Nullable keys are a nonsense and this feature is only needed for some crazy use-cases. This fixes #38941. #38946 (Amos Bird).
  • Improve fsync_part_directory for fetches. #38993 (Azat Khuzhin).
  • Fix possible dealock inside OvercommitTracker. Fixes #37794. #39030 (Dmitry Novik).
  • Fix bug in filesystem cache that could happen in some corner case which coincided with cache capacity hitting the limit. Closes #39066. #39070 (Kseniia Sumarokova).
  • Fix some corner cases of interpretation of the arguments of window expressions. Fixes #38538 Allow using of higher-order functions in window expressions. #39112 (Dmitry Novik).
  • Keep LowCardinality type in tuple function. Previously LowCardinality type was dropped and elements of created tuple had underlying type of LowCardinality. #39113 (Anton Popov).
  • Fix error Block structure mismatch which could happen for INSERT into table with attached MATERIALIZED VIEW and enabled setting extremes = 1. Closes #29759 and #38729. #39125 (Nikolai Kochetov).
  • Fix unexpected query result when both optimize_trivial_count_query and empty_result_for_aggregation_by_empty_set are set to true. This fixes #39140. #39155 (Amos Bird).
  • Fixed error Not found column Type in block in selects with PREWHERE and read-in-order optimizations. #39157 (Yakov Olkhovskiy).
  • Fix extremely rare race condition in during hardlinks for remote filesystem. The only way to reproduce it is concurrent run of backups. #39190 (alesapin).
  • (zero-copy replication is an experimental feature that should not be used in production) Fix fetch of in-memory part with allow_remote_fs_zero_copy_replication. #39214 (Azat Khuzhin).
  • (MaterializedPostgreSQL - experimental feature). Fix segmentation fault in MaterializedPostgreSQL database engine, which could happen if some exception occurred at replication initialisation. Closes #36939. #39272 (Kseniia Sumarokova).
  • Fix incorrect fetch of table metadata from PostgreSQL database engine. Closes #33502. #39283 (Kseniia Sumarokova).
  • Fix projection exception when aggregation keys are wrapped inside other functions. This fixes #37151. #37155 (Amos Bird).
  • Fix possible logical error ... with argument with type Nothing and default implementation for Nothing is expected to return result with type Nothing, got ... in some functions. Closes: #37610 Closes: #37741. #37759 (Kruglov Pavel).
  • Fix incorrect columns order in subqueries of UNION (in case of duplicated columns in subselects may produce incorrect result). #37887 (Azat Khuzhin).
  • Fix incorrect work of MODIFY ALTER Column with column names that contain dots. Closes #37907. #37971 (Kruglov Pavel).
  • Fix reading of sparse columns from MergeTree tables that store their data in S3. #37978 (Anton Popov).
  • Fix possible crash in Distributed async insert in case of removing a replica from config. #38029 (Nikolai Kochetov).
  • Fix "Missing columns" for GLOBAL JOIN with CTE without alias. #38056 (Azat Khuzhin).
  • Rewrite tuple functions as literals in backwards-compatibility mode. #38096 (Anton Kozlov).
  • Fix redundant memory reservation for output block during ORDER BY. #38127 (iyupeng).
  • Fix possible logical error Bad cast from type DB::IColumn* to DB::ColumnNullable* in array mapped functions. Closes #38006. #38132 (Kruglov Pavel).
  • Fix temporary name clash in partial merge join, close #37928. #38135 (Vladimir C).
  • Some minr issue with queries like CREATE TABLE nested_name_tuples (a Tuple(x String, y Tuple(i Int32, j String))) ENGINE = Memory; #38136 (lgbo).
  • Fix bug with nested short-circuit functions that led to execution of arguments even if condition is false. Closes #38040. #38173 (Kruglov Pavel).
  • (Window View is a experimental feature) Fix LOGICAL_ERROR for WINDOW VIEW with incorrect structure. #38205 (Azat Khuzhin).
  • Update librdkafka submodule to fix crash when an OAUTHBEARER refresh callback is set. #38225 (Rafael Acevedo).
  • Fix INSERT into Distributed hung due to ProfileEvents. #38307 (Azat Khuzhin).
  • Fix retries in PostgreSQL engine. #38310 (Kseniia Sumarokova).
  • Fix optimization in PartialSortingTransform (SIGSEGV and possible incorrect result). #38324 (Azat Khuzhin).
  • Fix RabbitMQ with formats based on PeekableReadBuffer. Closes #38061. #38356 (Kseniia Sumarokova).
  • MaterializedPostgreSQL - experimentail feature. Fix possible Invalid number of rows in Chunk in MaterializedPostgreSQL. Closes #37323. #38360 (Kseniia Sumarokova).
  • Fix RabbitMQ configuration with connection string setting. Closes #36531. #38365 (Kseniia Sumarokova).
  • Fix PostgreSQL engine not using PostgreSQL schema when retrieving array dimension size. Closes #36755. Closes #36772. #38366 (Kseniia Sumarokova).
  • Fix possibly incorrect result of distributed queries with DISTINCT and LIMIT. Fixes #38282. #38371 (Anton Popov).
  • Fix wrong results of countSubstrings() & position() on patterns with 0-bytes. #38589 (Robert Schulze).
  • Now it's possible to start a clickhouse-server and attach/detach tables even for tables with the incorrect values of IPv4/IPv6 representation. Proper fix for issue #35156. #38590 (alesapin).
  • rankCorr function will work correctly if some arguments are NaNs. This closes #38396. #38722 (Alexey Milovidov).
  • Fix parallel_view_processing=1 with optimize_trivial_insert_select=1. Fix max_insert_threads while pushing to views. #38731 (Azat Khuzhin).
  • Fix use-after-free for aggregate functions with Map combinator that leads to incorrect result. #38748 (Azat Khuzhin).

ClickHouse release 22.6, 2022-06-16​

Backward Incompatible Change​

  • Remove support for octal number literals in SQL. In previous versions they were parsed as Float64. #37765 (Yakov Olkhovskiy).
  • Changes how settings using seconds as type are parsed to support floating point values (for example: max_execution_time=0.5). Infinity or NaN values will throw an exception. #37187 (Raúl Marín).
  • Changed format of binary serialization of columns of experimental type Object. New format is more convenient to implement by third-party clients. #37482 (Anton Popov).
  • Turn on setting output_format_json_named_tuples_as_objects by default. It allows to serialize named tuples as JSON objects in JSON formats. #37756 (Anton Popov).
  • LIKE patterns with trailing escape symbol ('\') are now disallowed (as mandated by the SQL standard). #37764 (Robert Schulze).
  • If you run different ClickHouse versions on a cluster with AArch64 CPU or mix AArch64 and amd64 on a cluster, and use distributed queries with GROUP BY multiple keys of fixed-size type that fit in 256 bits but don't fit in 64 bits, and the size of the result is huge, the data will not be fully aggregated in the result of these queries during upgrade. Workaround: upgrade with downtime instead of a rolling upgrade.

New Feature​

  • Add GROUPING function. It allows to disambiguate the records in the queries with ROLLUP, CUBE or GROUPING SETS. Closes #19426. #37163 (Dmitry Novik).
  • A new codec FPC algorithm for floating point data compression. #37553 (Mikhail Guzov).
  • Add new columnar JSON formats: JSONColumns, JSONCompactColumns, JSONColumnsWithMetadata. Closes #36338 Closes #34509. #36975 (Kruglov Pavel).
  • Added open telemetry traces visualizing tool based on d3js. #37810 (Sergei Trifonov).
  • Support INSERTs into system.zookeeper table. Closes #22130. #37596 (Han Fei).
  • Support non-constant pattern argument for LIKE, ILIKE and match functions. #37251 (Robert Schulze).
  • Executable user defined functions now support parameters. Example: SELECT test_function(parameters)(arguments). Closes #37578. #37720 (Maksim Kita).
  • Add merge_reason column to system.part_log table. #36912 (Sema Checherinda).
  • Add support for Maps and Records in Avro format. Add new setting input_format_avro_null_as_default that allow to insert null as default in Avro format. Closes #18925 Closes #37378 Closes #32899. #37525 (Kruglov Pavel).
  • Add clickhouse-disks tool to introspect and operate on virtual filesystems configured for ClickHouse. #36060 (Artyom Yurkov).
  • Adds H3 unidirectional edge functions. #36843 (Bharat Nallan).
  • Add support for calculating hashids from unsigned integers. #37013 (Michael Nutt).
  • Explicit SALT specification is allowed for CREATE USER <user> IDENTIFIED WITH sha256_hash. #37377 (Yakov Olkhovskiy).
  • Add two new settings input_format_csv_skip_first_lines/input_format_tsv_skip_first_lines to allow skipping specified number of lines in the beginning of the file in CSV/TSV formats. #37537 (Kruglov Pavel).
  • showCertificate function shows current server's SSL certificate. #37540 (Yakov Olkhovskiy).
  • HTTP source for Data Dictionaries in Named Collections is supported. #37581 (Yakov Olkhovskiy).
  • Added a new window function nonNegativeDerivative(metric_column, timestamp_column[, INTERVAL x SECOND]). #37628 (Andrey Zvonov).
  • Implemented changing the comment for ReplicatedMergeTree tables. #37416 (Vasily Nemkov).
  • Added SYSTEM UNFREEZE query that deletes the whole backup regardless if the corresponding table is deleted or not. #36424 (Vadim Volodin).

Experimental Feature​

  • Enables POPULATE for WINDOW VIEW. #36945 (vxider).
  • ALTER TABLE ... MODIFY QUERY support for WINDOW VIEW. #37188 (vxider).
  • This PR changes the behavior of the ENGINE syntax in WINDOW VIEW, to make it like in MATERIALIZED VIEW. #37214 (vxider).

Performance Improvement​

  • Added numerous optimizations for ARM NEON #38093(Daniel Kutenin), (Alexandra Pilipyuk) Note: if you run different ClickHouse versions on a cluster with ARM CPU and use distributed queries with GROUP BY multiple keys of fixed-size type that fit in 256 bits but don't fit in 64 bits, the result of the aggregation query will be wrong during upgrade. Workaround: upgrade with downtime instead of a rolling upgrade.
  • Improve performance and memory usage for select of subset of columns for formats Native, Protobuf, CapnProto, JSONEachRow, TSKV, all formats with suffixes WithNames/WithNamesAndTypes. Previously while selecting only subset of columns from files in these formats all columns were read and stored in memory. Now only required columns are read. This PR enables setting input_format_skip_unknown_fields by default, because otherwise in case of select of subset of columns exception will be thrown. #37192 (Kruglov Pavel).
  • Now more filters can be pushed down for join. #37472 (Amos Bird).
  • Load marks for only necessary columns when reading wide parts. #36879 (Anton Kozlov).
  • Improved performance of aggregation in case, when sparse columns (can be enabled by experimental setting ratio_of_defaults_for_sparse_serialization in MergeTree tables) are used as arguments in aggregate functions. #37617 (Anton Popov).
  • Optimize function COALESCE with two arguments. #37666 (Anton Popov).
  • Replace multiIf to if in case when multiIf has only one condition, because function if is more performant. #37695 (Anton Popov).
  • Improve performance of dictGetDescendants, dictGetChildren functions, create temporary parent to children hierarchical index per query, not per function call during query. Allow to specify BIDIRECTIONAL for HIERARHICAL attributes, dictionary will maintain parent to children index in memory, that way functions dictGetDescendants, dictGetChildren will not create temporary index per query. Closes #32481. #37148 (Maksim Kita).
  • Aggregates state destruction now may be posted on a thread pool. For queries with LIMIT and big state it provides significant speedup, e.g. select uniq(number) from numbers_mt(1e7) group by number limit 100 became around 2.5x faster. #37855 (Nikita Taranov).
  • Improve sort performance by single column. #37195 (Maksim Kita).
  • Improve performance of single column sorting using sorting queue specializations. #37990 (Maksim Kita).
  • Improved performance on array norm and distance functions 2x-4x times. #37394 (Alexander Gololobov).
  • Improve performance of number comparison functions using dynamic dispatch. #37399 (Maksim Kita).
  • Improve performance of ORDER BY with LIMIT. #37481 (Maksim Kita).
  • Improve performance of hasAll function using dynamic dispatch infrastructure. #37484 (Maksim Kita).
  • Improve performance of greatCircleAngle, greatCircleDistance, geoDistance functions. #37524 (Maksim Kita).
  • Improve performance of insert into MergeTree if there are multiple columns in ORDER BY. #35762 (Maksim Kita).
  • Fix excessive CPU usage in background when there are a lot of tables. #38028 (Maksim Kita).
  • Improve performance of not function using dynamic dispatch. #38058 (Maksim Kita).
  • Optimized the internal caching of re2 patterns which occur e.g. in LIKE and MATCH functions. #37544 (Robert Schulze).
  • Improve filter bitmask generator function all in one with AVX-512 instructions. #37588 (yaqi-zhao).
  • Apply read method threadpool for Hive integration engine. This will significantly speed up reading. #36328 (李扬).
  • When all the columns to read are partition keys, construct columns by the file's row number without real reading the Hive file. #37103 (lgbo).
  • Support multi disks for caching hive files. #37279 (lgbo).
  • Limiting the maximum cache usage per query can effectively prevent cache pool contamination. Related Issues. #37859 (Han Shukai).
  • Currently clickhouse directly downloads all remote files to the local cache (even if they are only read once), which will frequently cause IO of the local hard disk. In some scenarios, these IOs may not be necessary and may easily cause negative optimization. As shown in the figure below, when we run SSB Q1-Q4, the performance of the cache has caused negative optimization. #37516 (Han Shukai).
  • Allow to prune the list of files via virtual columns such as _file and _path when reading from S3. This is for #37174 , #23494. #37356 (Amos Bird).
  • In function: CompressedWriteBuffer::nextImpl(), there is an unnecessary write-copy step that would happen frequently during inserting data. Below shows the differentiation with this patch: - Before: 1. Compress "working_buffer" into "compressed_buffer" 2. write-copy into "out" - After: Directly Compress "working_buffer" into "out". #37242 (jasperzhu).

Improvement​

  • Support types with non-standard defaults in ROLLUP, CUBE, GROUPING SETS. Closes #37360. #37667 (Dmitry Novik).
  • Fix stack traces collection on ARM. Closes #37044. Closes #15638. #37797 (Maksim Kita).
  • Client will try every IP address returned by DNS resolution until successful connection. #37273 (Yakov Olkhovskiy).
  • Allow to use String type instead of Binary in Arrow/Parquet/ORC formats. This PR introduces 3 new settings for it: output_format_arrow_string_as_string, output_format_parquet_string_as_string, output_format_orc_string_as_string. Default value for all settings is false. #37327 (Kruglov Pavel).
  • Apply setting input_format_max_rows_to_read_for_schema_inference for all read rows in total from all files in globs. Previously setting input_format_max_rows_to_read_for_schema_inference was applied for each file in glob separately and in case of huge number of nulls we could read first input_format_max_rows_to_read_for_schema_inference rows from each file and get nothing. Also increase default value for this setting to 25000. #37332 (Kruglov Pavel).
  • Add separate CLUSTER grant (and access_control_improvements.on_cluster_queries_require_cluster_grant configuration directive, for backward compatibility, default to false). #35767 (Azat Khuzhin).
  • Added support for schema inference for hdfsCluster. #35812 (Nikita Mikhaylov).
  • Implement least_used load balancing algorithm for disks inside volume (multi disk configuration). #36686 (Azat Khuzhin).
  • Modify the HTTP Endpoint to return the full stats under the X-ClickHouse-Summary header when send_progress_in_http_headers=0 (before it would return all zeros). - Modify the HTTP Endpoint to return X-ClickHouse-Exception-Code header when progress has been sent before (send_progress_in_http_headers=1) - Modify the HTTP Endpoint to return HTTP_REQUEST_TIMEOUT (408) instead of HTTP_INTERNAL_SERVER_ERROR (500) on TIMEOUT_EXCEEDED errors. #36884 (Raúl Marín).
  • Allow a user to inspect grants from granted roles. #36941 (nvartolomei).
  • Do not calculate an integral numerically but use CDF functions instead. This will speed up execution and will increase the precision. This fixes #36714. #36953 (Nikita Mikhaylov).
  • Add default implementation for Nothing in functions. Now most of the functions will return column with type Nothing in case one of it's arguments is Nothing. It also solves problem with functions like arrayMap/arrayFilter and similar when they have empty array as an argument. Previously queries like select arrayMap(x -> 2 * x, []); failed because function inside lambda cannot work with type Nothing, now such queries return empty array with type Array(Nothing). Also add support for arrays of nullable types in functions like arrayFilter/arrayFill. Previously, queries like select arrayFilter(x -> x % 2, [1, NULL]) failed, now they work (if the result of lambda is NULL, then this value won't be included in the result). Closes #37000. #37048 (Kruglov Pavel).
  • Now if a shard has local replica we create a local plan and a plan to read from all remote replicas. They have shared initiator which coordinates reading. #37204 (Nikita Mikhaylov).
  • Do no longer abort server startup if configuration option "mark_cache_size" is not explicitly set. #37326 (Robert Schulze).
  • Allows providing NULL/NOT NULL right after type in column declaration. #37337 (Igor Nikonov).
  • optimize file segment PARTIALLY_DOWNLOADED get read buffer. #37338 (xiedeyantu).
  • Try to improve short circuit functions processing to fix problems with stress tests. #37384 (Kruglov Pavel).
  • Closes #37395. #37415 (Memo).
  • Fix extremely rare deadlock during part fetch in zero-copy replication. Fixes #37423. #37424 (metahys).
  • Don't allow to create storage with unknown data format. #37450 (Kruglov Pavel).
  • Set global_memory_usage_overcommit_max_wait_microseconds default value to 5 seconds. Add info about OvercommitTracker to OOM exception message. Add MemoryOvercommitWaitTimeMicroseconds profile event. #37460 (Dmitry Novik).
  • Do not display -0.0 CPU time in clickhouse-client. It can appear due to rounding errors. This closes #38003. This closes #38038. #38064 (Alexey Milovidov).
  • Play UI: Keep controls in place when the page is scrolled horizontally. This makes edits comfortable even if the table is wide and it was scrolled far to the right. The feature proposed by Maksym Tereshchenko from CaspianDB. #37470 (Alexey Milovidov).
  • Modify query div in play.html to be extendable beyond 20% height. In case of very long queries it is helpful to extend the textarea element, only today, since the div is fixed height, the extended textarea hides the data div underneath. With this fix, extending the textarea element will push the data div down/up such the extended textarea won't hide it. Also, keeps query box width 100% even when the user adjusting the size of the query textarea. #37488 (guyco87).
  • Added ProfileEvents for introspection of type of written (inserted or merged) parts (Inserted{Wide/Compact/InMemory}Parts, MergedInto{Wide/Compact/InMemory}Parts. Added column part_type to system.part_log. Resolves #37495. #37536 (Anton Popov).
  • clickhouse-keeper improvement: move broken logs to a timestamped folder. #37565 (Antonio Andelic).
  • Do not write expired columns by TTL after subsequent merges (before only first merge/optimize of the part will not write expired by TTL columns, all other will do). #37570 (Azat Khuzhin).
  • More precise result of the dumpColumnStructure miscellaneous function in presence of LowCardinality or Sparse columns. In previous versions, these functions were converting the argument to a full column before returning the result. This is needed to provide an answer in #6935. #37633 (Alexey Milovidov).
  • clickhouse-keeper: store only unique session IDs for watches. #37641 (Azat Khuzhin).
  • Fix possible "Cannot write to finalized buffer". #37645 (Azat Khuzhin).
  • Add setting support_batch_delete for DiskS3 to disable multiobject delete calls, which Google Cloud Storage doesn't support. #37659 (Fred Wulff).
  • Add an option to disable connection pooling in ODBC bridge. #37705 (Anton Kozlov).
  • Functions dictGetHierarchy, dictIsIn, dictGetChildren, dictGetDescendants added support nullable HIERARCHICAL attribute in dictionaries. Closes #35521. #37805 (Maksim Kita).
  • Expose BoringSSL version related info in the system.build_options table. #37850 (Bharat Nallan).
  • Now clickhouse-server removes delete_tmp directories on server start. Fixes #26503. #37906 (alesapin).
  • Clean up broken detached parts after timeout. Closes #25195. #37975 (Kseniia Sumarokova).
  • Now in MergeTree table engines family failed-to-move parts will be removed instantly. #37994 (alesapin).
  • Now if setting always_fetch_merged_part is enabled for ReplicatedMergeTree merges will try to find parts on other replicas rarely with smaller load for [Zoo]Keeper. #37995 (alesapin).
  • Add implicit grants with grant option too. For example GRANT CREATE TABLE ON test.* TO A WITH GRANT OPTION now allows A to execute GRANT CREATE VIEW ON test.* TO B. #38017 (Vitaly Baranov).

Build/Testing/Packaging Improvement​

Bug Fix​

  • Fix SELECT ... INTERSECT and EXCEPT SELECT statements with constant string types. #37738 (Antonio Andelic).
  • Fix GROUP BY AggregateFunction (i.e. you GROUP BY by the column that has AggregateFunction type). #37093 (Azat Khuzhin).
  • (experimental WINDOW VIEW) Fix addDependency in WindowView. This bug can be reproduced like #37237. #37224 (vxider).
  • Fix inconsistency in ORDER BY ... WITH FILL feature. Query, containing ORDER BY ... WITH FILL, can generate extra rows when multiple WITH FILL columns are present. #38074 (Yakov Olkhovskiy).
  • This PR moving addDependency from constructor to startup() to avoid adding dependency to a dropped table, fix #37237. #37243 (vxider).
  • Fix inserting defaults for missing values in columnar formats. Previously missing columns were filled with defaults for types, not for columns. #37253 (Kruglov Pavel).
  • (experimental Object type) Fix some cases of insertion nested arrays to columns of type Object. #37305 (Anton Popov).
  • Fix unexpected errors with a clash of constant strings in aggregate function, prewhere and join. Close #36891. #37336 (Vladimir C).
  • Fix projections with GROUP/ORDER BY in query and optimize_aggregation_in_order (before the result was incorrect since only finish sorting was performed). #37342 (Azat Khuzhin).
  • Fixed error with symbols in key name in S3. Fixes #33009. #37344 (Vladimir Chebotarev).
  • Throw an exception when GROUPING SETS used with ROLLUP or CUBE. #37367 (Dmitry Novik).
  • Fix LOGICAL_ERROR in getMaxSourcePartsSizeForMerge during merges (in case of non standard, greater, values of background_pool_size/background_merges_mutations_concurrency_ratio has been specified in config.xml (new way) not in users.xml (deprecated way)). #37413 (Azat Khuzhin).
  • Stop removing UTF-8 BOM in RowBinary format. #37428 (Paul Loyd). #37428 (Paul Loyd).
  • clickhouse-keeper bugfix: fix force recovery for single node cluster. #37440 (Antonio Andelic).
  • Fix logical error in normalizeUTF8 functions. Closes #37298. #37443 (Maksim Kita).
  • Fix cast lowcard of nullable in JoinSwitcher, close #37385. #37453 (Vladimir C).
  • Fix named tuples output in ORC/Arrow/Parquet formats. #37458 (Kruglov Pavel).
  • Fix optimization of monotonous functions in ORDER BY clause in presence of GROUPING SETS. Fixes #37401. #37493 (Dmitry Novik).
  • Fix error on joining with dictionary on some conditions. Close #37386. #37530 (Vladimir C).
  • Prohibit optimize_aggregation_in_order with GROUPING SETS (fixes LOGICAL_ERROR). #37542 (Azat Khuzhin).
  • Fix wrong dump information of ActionsDAG. #37587 (zhanglistar).
  • Fix converting types for UNION queries (may produce LOGICAL_ERROR). #37593 (Azat Khuzhin).
  • Fix WITH FILL modifier with negative intervals in STEP clause. Fixes #37514. #37600 (Anton Popov).
  • Fix illegal joinGet array usage when join_use_nulls = 1. This fixes #37562 . #37650 (Amos Bird).
  • Fix columns number mismatch in cross join, close #37561. #37653 (Vladimir C).
  • Fix segmentation fault in show create table from mysql database when it is configured with named collections. Closes #37683. #37690 (Kseniia Sumarokova).
  • Fix RabbitMQ Storage not being able to startup on server restart if storage was create without SETTINGS clause. Closes #37463. #37691 (Kseniia Sumarokova).
  • SQL user defined functions disable CREATE/DROP in readonly mode. Closes #37280. #37699 (Maksim Kita).
  • Fix formatting of Nullable arguments for executable user defined functions. Closes #35897. #37711 (Maksim Kita).
  • Fix optimization enabled by setting optimize_monotonous_functions_in_order_by in distributed queries. Fixes #36037. #37724 (Anton Popov).
  • Fix possible logical error: Invalid Field get from type UInt64 to type Float64 in values table function. Closes #37602. #37754 (Kruglov Pavel).
  • Fix possible segfault in schema inference in case of exception in SchemaReader constructor. Closes #37680. #37760 (Kruglov Pavel).
  • Fix setting cast_ipv4_ipv6_default_on_conversion_error for internal cast function. Closes #35156. #37761 (Maksim Kita).
  • Fix toString error on DatatypeDate32. #37775 (LiuNeng).
  • The clickhouse-keeper setting dead_session_check_period_ms was transformed into microseconds (multiplied by 1000), which lead to dead sessions only being cleaned up after several minutes (instead of 500ms). #37824 (Michael Lex).
  • Fix possible "No more packets are available" for distributed queries (in case of async_socket_for_remote/use_hedged_requests is disabled). #37826 (Azat Khuzhin).
  • (experimental WINDOW VIEW) Do not drop the inner target table when executing ALTER TABLE … MODIFY QUERY in WindowView. #37879 (vxider).
  • Fix directory ownership of coordination dir in clickhouse-keeper Docker image. Fixes #37914. #37915 (James Maidment).
  • Dictionaries fix custom query with update field and {condition}. Closes #33746. #37947 (Maksim Kita).
  • Fix possible incorrect result of SELECT ... WITH FILL in the case when ORDER BY should be applied after WITH FILL result (e.g. for outer query). Incorrect result was caused by optimization for ORDER BY expressions (#35623). Closes #37904. #37959 (Yakov Olkhovskiy).
  • (experimental WINDOW VIEW) Add missing default columns when pushing to the target table in WindowView, fix #37815. #37965 (vxider).
  • Fixed too large stack frame that would cause compilation to fail. #37996 (Han Shukai).
  • When open enable_filesystem_query_cache_limit, throw Reserved cache size exceeds the remaining cache size. #38004 (xiedeyantu).
  • Fix converting types for UNION queries (may produce LOGICAL_ERROR). #34775 (Azat Khuzhin).
  • TTL merge may not be scheduled again if BackgroundExecutor is busy. --merges_with_ttl_counter is increased in selectPartsToMerge() --merge task will be ignored if BackgroundExecutor is busy --merges_with_ttl_counter will not be decrease. #36387 (lthaooo).
  • Fix overridden settings value of normalize_function_names. #36937 (李扬).
  • Fix for exponential time decaying window functions. Now respecting boundaries of the window. #36944 (Vladimir Chebotarev).
  • Fix possible heap-use-after-free error when reading system.projection_parts and system.projection_parts_columns . This fixes #37184. #37185 (Amos Bird).
  • Fixed DateTime64 fractional seconds behavior prior to Unix epoch. #37697 (Andrey Zvonov). #37039 (李扬).

ClickHouse release 22.5, 2022-05-19​

Upgrade Notes​

  • Now, background merges, mutations and OPTIMIZE will not increment SelectedRows and SelectedBytes metrics. They (still) will increment MergedRows and MergedUncompressedBytes as it was before. This only affects the metric values, and makes them better. This change does not introduce any incompatibility, but you may wonder about the changes of metrics, so we put in this category. #37040 (Nikolai Kochetov).
  • Updated the BoringSSL module to the official FIPS compliant version. This makes ClickHouse FIPS compliant. #35914 (Meena-Renganathan). The ciphers aes-192-cfb128 and aes-256-cfb128 were removed, because they are not included in the FIPS certified version of BoringSSL.
  • max_memory_usage setting is removed from the default user profile in users.xml. This enables flexible memory limits for queries instead of the old rigid limit of 10 GB.
  • Disable log_query_threads setting by default. It controls the logging of statistics about every thread participating in query execution. After supporting asynchronous reads, the total number of distinct thread ids became too large, and logging into the query_thread_log has become too heavy. #37077 (Alexey Milovidov).
  • Remove function groupArraySorted which has a bug. #36822 (Alexey Milovidov).

New Feature​

  • Enable memory overcommit by default. #35921 (Dmitry Novik).
  • Add support of GROUPING SETS in GROUP BY clause. This implementation supports a parallel processing of grouping sets. #33631 (Dmitry Novik).
  • Added system.certificates table. #37142 (Yakov Olkhovskiy).
  • Adds h3Line, h3Distance and h3HexRing functions. #37030 (Bharat Nallan).
  • New single binary based diagnostics tool (clickhouse-diagnostics). #36705 (Dale McDiarmid).
  • Add output format Prometheus #36051. #36206 (Vladimir C).
  • Add MySQLDump input format. It reads all data from INSERT queries belonging to one table in dump. If there are more than one table, by default it reads data from the first one. #36667 (Kruglov Pavel).
  • Show the total_rows and total_bytes fields in system.tables for temporary tables. #36401. #36439 (xiedeyantu).
  • Allow to override parts_to_delay_insert and parts_to_throw_insert with query-level settings. If they are defined, they will override table-level settings. #36371 (Memo).

Experimental Feature​

  • Implemented L1, L2, Linf, Cosine distance functions for arrays and L1, L2, Linf norm functions for arrays. #37033 (qieqieplus). Caveat: the functions will be renamed.
  • Improve the WATCH query in WindowView: 1. Reduce the latency of providing query results by calling the fire_condition signal. 2. Makes the cancel query operation(ctrl-c) faster, by checking isCancelled() more frequently. #37226 (vxider).
  • Introspection for remove filesystem cache. #36802 (Han Shukai).
  • Added new hash function wyHash64 for SQL. #36467 (olevino).
  • Improvement for replicated databases: Added SYSTEM SYNC DATABASE REPLICA query which allows to sync tables metadata inside Replicated database, because currently synchronisation is asynchronous. #35944 (Nikita Mikhaylov).
  • Improvement for remote filesystem cache: Better read from cache. #37054 (Kseniia Sumarokova). Improve SYSTEM DROP FILESYSTEM CACHE query: <path> option and FORCE option. #36639 (Kseniia Sumarokova).
  • Improvement for semistructured data: Allow to cast columns of type Object(...) to Object(Nullable(...)). #36564 (awakeljw).
  • Improvement for parallel replicas: We create a local interpreter if we want to execute query on localhost replica. But for when executing query on multiple replicas we rely on the fact that a connection exists so replicas can talk to coordinator. It is now improved and localhost replica can talk to coordinator directly in the same process. #36281 (Nikita Mikhaylov).

Performance Improvement​

  • Improve performance of avg, sum aggregate functions if used without GROUP BY expression. #37257 (Maksim Kita).
  • Improve performance of unary arithmetic functions (bitCount, bitNot, abs, intExp2, intExp10, negate, roundAge, roundDuration, roundToExp2, sign) using dynamic dispatch. #37289 (Maksim Kita).
  • Improve performance of ORDER BY, MergeJoin, insertion into MergeTree using JIT compilation of sort columns comparator. #34469 (Maksim Kita).
  • Change structure of system.asynchronous_metric_log. It will take about 10 times less space. This closes #36357. The field event_time_microseconds was removed, because it is useless. #36360 (Alexey Milovidov).
  • Load marks for only necessary columns when reading wide parts. #36879 (Anton Kozlov).
  • Improves performance of file descriptor cache by narrowing mutex scopes. #36682 (Anton Kozlov).
  • Improve performance of reading from storage File and table functions file in case when path has globs and matched directory contains large number of files. #36647 (Anton Popov).
  • Apply parallel parsing for input format HiveText, which can speed up HiveText parsing by 2x when reading local file. #36650 (李扬).
  • The default HashJoin is not thread safe for inserting right table's rows and run it in a single thread. When the right table is large, the join process is too slow with low cpu utilization. #36415 (lgbo).
  • Allow to rewrite select countDistinct(a) from t to select count(1) from (select a from t groupBy a). #35993 (zhanglistar).
  • Transform OR LIKE chain to multiMatchAny. Will enable once we have more confidence it works. #34932 (Daniel Kutenin).
  • Improve performance of some functions with inlining. #34544 (Daniel Kutenin).
  • Add a branch to avoid unnecessary memcpy in readBig. It improves performance somewhat. #36095 (jasperzhu).
  • Implement partial GROUP BY key for optimize_aggregation_in_order. #35111 (Azat Khuzhin).

Improvement​

  • Show names of erroneous files in case of parsing errors while executing table functions file, s3 and url. #36314 (Anton Popov).
  • Allowed to increase the number of threads for executing background operations (merges, mutations, moves and fetches) at runtime if they are specified at top level config. #36425 (Nikita Mikhaylov).
  • Now date time conversion functions that generates time before 1970-01-01 00:00:00 with partial hours/minutes timezones will be saturated to zero instead of overflow. This is the continuation of https://github.com/ClickHouse/ClickHouse/pull/29953 which addresses https://github.com/ClickHouse/ClickHouse/pull/29953#discussion_r800550280 . Mark as improvement because it's implementation defined behavior (and very rare case) and we are allowed to break it. #36656 (Amos Bird).
  • Add a warning if someone running clickhouse-server with log level "test". The log level "test" was added recently and cannot be used in production due to inevitable, unavoidable, fatal and life-threatening performance degradation. #36824 (Alexey Milovidov).
  • Parse collations in CREATE TABLE, throw exception or ignore. closes #35892. #36271 (yuuch).
  • Option compatibility_ignore_auto_increment_in_create_table allows ignoring AUTO_INCREMENT keyword in a column declaration to simplify migration from MySQL. #37178 (Igor Nikonov).
  • Add aliases JSONLines and NDJSON for JSONEachRow. Closes #36303. #36327 (flynn).
  • Limit the max partitions could be queried for each hive table. Avoid resource overruns. #37281 (lgbo).
  • Added implicit cast for h3kRing function second argument to improve usability. Closes #35432. #37189 (Maksim Kita).
  • Fix progress indication for INSERT SELECT in clickhouse-local for any query and for file progress in client, more correct file progress. #37075 (Kseniia Sumarokova).
  • Fix bug which can lead to forgotten outdated parts in MergeTree table engines family in case of filesystem failures during parts removal. Before fix they will be removed only after first server restart. #37014 (alesapin).
  • Implemented a new mode of handling row policies which can be enabled in the main configuration which enables users without permissive row policies to read rows. #36997 (Vitaly Baranov).
  • Play UI: Nullable numbers will be aligned to the right in table cells. This closes #36982. #36988 (Alexey Milovidov).
  • Play UI: If there is one row in result and more than a few columns, display the result vertically. Continuation of #36811. #36842 (Alexey Milovidov).
  • Cleanup CSS in Play UI. The pixels are more evenly placed. Better usability for long content in table cells. #36569 (Alexey Milovidov).
  • Finalize write buffers in case of exception to avoid doing it in destructors. Hope it fixes: #36907. #36979 (Kruglov Pavel).
  • After #36425 settings like background_fetches_pool_size became obsolete and can appear in top level config, but clickhouse throws and exception like Error updating configuration from '/etc/clickhouse-server/config.xml' config.: Code: 137. DB::Exception: A setting 'background_fetches_pool_size' appeared at top level in config /etc/clickhouse-server/config.xml. This is fixed. #36917 (Nikita Mikhaylov).
  • Add extra diagnostic info (if applicable) when sending exception to other server. #36872 (tavplubix).
  • Allow to execute hash functions with arguments of type Array(Tuple(..)). #36812 (Anton Popov).
  • Added user_defined_path config setting. #36753 (Maksim Kita).
  • Allow cluster macro in s3Cluster table function. #36726 (Vadim Volodin).
  • Properly cancel INSERT queries in clickhouse-client/clickhouse-local. #36710 (Azat Khuzhin).
  • Allow to cancel a query while still keeping a decent query id in MySQLHandler. #36699 (Amos Bird).
  • Add is_all_data_sent column into system.processes, and improve internal testing hardening check based on it. #36649 (Azat Khuzhin).
  • The metrics about time spent reading from s3 now calculated correctly. Close #35483. #36572 (Alexey Milovidov).
  • Allow file descriptors in table function file if it is run in clickhouse-local. #36562 (wuxiaobai24).
  • Allow names of tuple elements that start from digits. #36544 (Anton Popov).
  • Now clickhouse-benchmark can read authentication info from environment variables. #36497 (Anton Kozlov).
  • clickhouse-keeper improvement: add support for force recovery which allows you to reconfigure cluster without quorum. #36258 (Antonio Andelic).
  • Improve schema inference for JSON objects. #36207 (Kruglov Pavel).
  • Refactor code around schema inference with globs. Try next file from glob only if it makes sense (previously we tried next file in case of any error). Also it fixes #36317. #36205 (Kruglov Pavel).
  • Add a separate CLUSTER grant (and access_control_improvements.on_cluster_queries_require_cluster_grant configuration directive, for backward compatibility, default to false). #35767 (Azat Khuzhin).
  • If the required amount of memory is available before the selected query stopped, all waiting queries continue execution. Now we don't stop any query if memory is freed before the moment when the selected query knows about the cancellation. #35637 (Dmitry Novik).
  • Nullables detection in protobuf. In proto3, default values are not sent on the wire. This makes it non-trivial to distinguish between null and default values for Nullable columns. A standard way to deal with this problem is to use Google wrappers to nest the target value within an inner message (see https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/wrappers.proto). In this case, a missing field is interpreted as null value, a field with missing value if interpreted as default value, and a field with regular value is interpreted as regular value. However, ClickHouse interprets Google wrappers as nested columns. We propose to introduce special behaviour to detect Google wrappers and interpret them like in the description above. For example, to serialize values for a Nullable column test, we would use google.protobuf.StringValue test in our .proto schema. Note that these types are so called "well-known types" in Protobuf, implemented in the library itself. #35149 (Jakub Kuklis).
  • Added support for specifying content_type in predefined and static HTTP handler config. #34916 (Roman Nikonov).
  • Warn properly if use clickhouse-client --file without preceeding --external. Close #34747. #34765 (李扬).
  • Improve MySQL database engine to compatible with binary(0) dataType. #37232 (zzsmdfj).
  • Improve JSON report of clickhouse-benchmark. #36473 (Tian Xinhui).
  • Server might refuse to start if it cannot resolve hostname of external ClickHouse dictionary. It's fixed. Fixes #36451. #36463 (tavplubix).

Build/Testing/Packaging Improvement​

  • Now clickhouse-keeper for the x86_64 architecture is statically linked with musl and doesn't depend on any system libraries. #31833 (Alexey Milovidov).
  • ClickHouse builds for PowerPC64LE architecture are now available in universal installation script curl https://clickhouse.com/ | sh and by direct link https://builds.clickhouse.com/master/powerpc64le/clickhouse. #37095 (Alexey Milovidov).
  • Limit PowerPC code generation to Power8 for better compatibility. This closes #36025. #36529 (Alexey Milovidov).
  • Simplify performance test. This will give a chance for us to use it. #36769 (Alexey Milovidov).
  • Fail performance comparison on errors in the report. #34797 (Mikhail f. Shiryaev).
  • Add ZSTD support for Arrow. This fixes #35283. #35486 (Sean Lafferty).

Bug Fix​

  • Extracts Version ID if present from the URI and adds a request to the AWS HTTP URI. Closes #31221. - [x] Extract Version ID from URI if present and reassemble without it. - [x] Configure AWS HTTP URI object with request. - [x] Unit Tests: gtest_s3_uri - [x] Drop instrumentation commit. #34571 (Saad Ur Rahman).
  • Fix system.opentelemetry_span_log attribute.values alias to values instead of keys. #37275 (Aleksandr Razumov).
  • Fix Nullable(String) to Nullable(Bool/IPv4/IPv6) conversion Closes #37221. #37270 (Kruglov Pavel).
  • Experimental feature: Fix execution of mutations in tables, in which there exist columns of type Object. Using subcolumns of type Object in WHERE expression of UPDATE or DELETE queries is now allowed yet, as well as manipulating (DROP, MODIFY) of separate subcolumns. Fixes #37205. #37266 (Anton Popov).
  • Kafka does not need group.id on producer stage. In console log you can find Warning that describe this issue: 2022.05.15 17:59:13.270227 [ 137 ] {} <Warning> StorageKafka (topic-name): [rdk:CONFWARN] [thrd:app]: Configuration property group.id is a consumer property and will be ignored by this producer instance. #37228 (Mark Andreev).
  • Experimental feature (WindowView): Update max_fired_watermark after blocks actually fired, in case delete data that hasn't been fired yet. #37225 (vxider).
  • Fix "Cannot create column of type Set" for distributed queries with LIMIT BY. #37193 (Azat Khuzhin).
  • Experimental feature: Now WindowView WATCH EVENTS query will not be terminated due to the nonempty Chunk created in WindowViewSource.h:58. #37182 (vxider).
  • Enable enable_global_with_statement for subqueries, close #37141. #37166 (Vladimir C).
  • Fix implicit cast for optimize_skip_unused_shards_rewrite_in. #37153 (Azat Khuzhin).
  • The ILIKE function on FixedString columns could have returned wrong results (i.e. match less than it should). #37117 (Robert Schulze).
  • Fix GROUP BY AggregateFunction (i.e. you GROUP BY by the column that has AggregateFunction type). #37093 (Azat Khuzhin).
  • Experimental feature: Fix optimize_aggregation_in_order with prefix GROUP BY and *Array aggregate functions. #37050 (Azat Khuzhin).
  • Fixed performance degradation of some INSERT SELECT queries with implicit aggregation. Fixes #36792. #37047 (tavplubix).
  • Experimental feature: Fix in-order GROUP BY (optimize_aggregation_in_order=1) with *Array (groupArrayArray/...) aggregate functions. #37046 (Azat Khuzhin).
  • Fix LowCardinality->ArrowDictionary invalid output when type of indexes is not UInt8. Closes #36832. #37043 (Kruglov Pavel).
  • Fixed problem with infs in quantileTDigest. Fixes #32107. #37021 (Vladimir Chebotarev).
  • Fix sending external tables data in HedgedConnections with max_parallel_replicas != 1. #36981 (Kruglov Pavel).
  • Fixed logical error on TRUNCATE query in Replicated database. Fixes #33747. #36976 (tavplubix).
  • Experimental feature: Fix stuck when dropping source table in WindowView. Closes #35678. #36967 (vxider).
  • Experimental feature (rocksdb cache): Fix issue: #36671. #36929 (李扬).
  • Experimental feature: Fix bugs when using multiple columns in WindowView by adding converting actions to make it possible to callwriteIntoWindowView with a slightly different schema. #36928 (vxider).
  • Fix bug in clickhouse-keeper which can lead to corrupted compressed log files in case of small load and restarts. #36910 (alesapin).
  • Fix incorrect query result when doing constant aggregation. This fixes #36728 . #36888 (Amos Bird).
  • Experimental feature: Fix current_size count in cache. #36887 (Kseniia Sumarokova).
  • Experimental feature: Fix fire in window view with hop window #34044. #36861 (vxider).
  • Experimental feature: Fix incorrect cast in cached buffer from remote fs. #36809 (Kseniia Sumarokova).
  • Fix creation of tables with flatten_nested = 0. Previously unflattened Nested columns could be flattened after server restart. #36803 (Anton Popov).
  • Fix some issues with async reads from remote filesystem which happened when reading low cardinality. #36763 (Kseniia Sumarokova).
  • Experimental feature: Fix insertion to columns of type Object from multiple files, e.g. via table function file with globs. #36762 (Anton Popov).
  • Fix timeouts in Hedged requests. Connection hang right after sending remote query could lead to eternal waiting. #36749 (Kruglov Pavel).
  • Experimental feature: Fix a bug of groupBitmapAndState/groupBitmapOrState/groupBitmapXorState on distributed table. #36739 (Zhang Yifan).
  • Experimental feature: During the test in PR, I found that the one cache class was initialized twice, it throws a exception. Although the cause of this problem is not clear, there should be code logic of repeatedly loading disk in ClickHouse, so we need to make special judgment for this situation. #36737 (Han Shukai).
  • Fix vertical merges in wide parts. Previously an exception There is no column can be thrown during merge. #36707 (Anton Popov).
  • Fix server reload on port change (do not wait for current connections from query context). #36700 (Azat Khuzhin).
  • Experimental feature: In the previous PR, I found that testing (stateless tests, flaky check (address, actions)) is timeout. Moreover, testing locally can also trigger unstable system deadlocks. This problem still exists when using the latest source code of master. #36697 (Han Shukai).
  • Experimental feature: Fix server restart if cache configuration changed. #36685 (Kseniia Sumarokova).
  • Fix possible heap-use-after-free in schema inference. Closes #36661. #36679 (Kruglov Pavel).
  • Fixed parsing of query settings in CREATE query when engine is not specified. Fixes https://github.com/ClickHouse/ClickHouse/pull/34187#issuecomment-1103812419. #36642 (tavplubix).
  • Experimental feature: Fix merges of wide parts with type Object. #36637 (Anton Popov).
  • Fix format crash when default expression follow EPHEMERAL not literal. Closes #36618. #36633 (flynn).
  • Fix Missing column exception which could happen while using INTERPOLATE with ENGINE = MergeTree table. #36549 (Yakov Olkhovskiy).
  • Fix potential error with literals in WHERE for join queries. Close #36279. #36542 (Vladimir C).
  • Fix offset update ReadBufferFromEncryptedFile, which could cause undefined behaviour. #36493 (Kseniia Sumarokova).
  • Fix hostname sanity checks for Keeper cluster configuration. Add keeper_server.host_checks_enabled config to enable/disable those checks. #36492 (Antonio Andelic).
  • Fix usage of executable user defined functions in GROUP BY. Before executable user defined functions cannot be used as expressions in GROUP BY. Closes #36448. #36486 (Maksim Kita).
  • Fix possible exception with unknown packet from server in client. #36481 (Kseniia Sumarokova).
  • Experimental feature (please never use system.session_log, it is going to be removed): Add missing enum values in system.session_log table. Closes #36474. #36480 (Memo).
  • Fix bug in s3Cluster schema inference that let to the fact that not all data was read in the select from s3Cluster. The bug appeared in https://github.com/ClickHouse/ClickHouse/pull/35544. #36434 (Kruglov Pavel).
  • Fix nullptr dereference in JOIN and COLUMNS matcher. This fixes #36416. This is for https://github.com/ClickHouse/ClickHouse/pull/36417. #36430 (Amos Bird).
  • Fix dictionary reload for ClickHouseDictionarySource if it contains scalar subqueries. #36390 (lthaooo).
  • Fix assertion in JOIN, close #36199. #36201 (Vladimir C).
  • Queries with aliases inside special operators returned parsing error (was broken in 22.1). Example: SELECT substring('test' AS t, 1, 1). #36167 (Maksim Kita).
  • Experimental feature: Fix insertion of complex JSONs with nested arrays to columns of type Object. #36077 (Anton Popov).
  • Fix ALTER DROP COLUMN of nested column with compact parts (i.e. ALTER TABLE x DROP COLUMN n, when there is column n.d). #35797 (Azat Khuzhin).
  • Fix substring function range error length when offset and length is negative constant and s is not constant. #33861 (RogerYK).

ClickHouse release 22.4, 2022-04-19​

Backward Incompatible Change​

  • Do not allow SETTINGS after FORMAT for INSERT queries (there is compatibility setting allow_settings_after_format_in_insert to accept such queries, but it is turned OFF by default). #35883 (Azat Khuzhin).
  • Function yandexConsistentHash (consistent hashing algorithm by Konstantin "kostik" Oblakov) is renamed to kostikConsistentHash. The old name is left as an alias for compatibility. Although this change is backward compatible, we may remove the alias in subsequent releases, that's why it's recommended to update the usages of this function in your apps. #35553 (Alexey Milovidov).

New Feature​

  • Added INTERPOLATE extension to the ORDER BY ... WITH FILL. Closes #34903. #35349 (Yakov Olkhovskiy).
  • Profiling on Processors level (under log_processors_profiles setting, ClickHouse will write time that processor spent during execution/waiting for data to system.processors_profile_log table). #34355 (Azat Khuzhin).
  • Added functions makeDate(year, month, day), makeDate32(year, month, day). #35628 (Alexander Gololobov). Implementation of makeDateTime() and makeDateTIme64(). #35934 (Alexander Gololobov).
  • Support new type of quota WRITTEN BYTES to limit amount of written bytes during insert queries. #35736 (Anton Popov).
  • Added function flattenTuple. It receives nested named Tuple as an argument and returns a flatten Tuple which elements are the paths from the original Tuple. E.g.: Tuple(a Int, Tuple(b Int, c Int)) -> Tuple(a Int, b Int, c Int). flattenTuple can be used to select all paths from type Object as separate columns. #35690 (Anton Popov).
  • Added functions arrayFirstOrNull, arrayLastOrNull. Closes #35238. #35414 (Maksim Kita).
  • Added functions minSampleSizeContinous and minSampleSizeConversion. Author achimbab. #35360 (Maksim Kita).
  • New functions minSampleSizeContinous and minSampleSizeConversion. #34354 (achimbab).
  • Introduce format ProtobufList (all records as repeated messages in out Protobuf). Closes #16436. #35152 (Nikolai Kochetov).
  • Add h3PointDistM, h3PointDistKm, h3PointDistRads, h3GetRes0Indexes, h3GetPentagonIndexes functions. #34568 (Bharat Nallan).
  • Add toLastDayOfMonth function which rounds up a date or date with time to the last day of the month. #33501. #34394 (Habibullah Oladepo).
  • Added load balancing setting for [Zoo]Keeper client. Closes #29617. #30325 (小路).
  • Add a new kind of row policies named simple. Before this PR we had two kinds or row policies: permissive and restrictive. A simple row policy adds a new filter on a table without any side-effects like it was for permissive and restrictive policies. #35345 (Vitaly Baranov).
  • Added an ability to specify cluster secret in replicated database. #35333 (Nikita Mikhaylov).
  • Added sanity checks on server startup (available memory and disk space, max thread count, etc). #34566 (Sergei Trifonov).
  • INTERVAL improvement - can be used with [MILLI|MICRO|NANO]SECOND. Added toStartOf[Milli|Micro|Nano]second() functions. Added [add|subtract][Milli|Micro|Nano]seconds(). #34353 (Andrey Zvonov).

Experimental Feature​

  • Added support for transactions for simple MergeTree tables. This feature is highly experimental and not recommended for production. Part of #22086. #24258 (tavplubix).
  • Support schema inference for type Object in format JSONEachRow. Allow to convert columns of type Map to columns of type Object. #35629 (Anton Popov).
  • Allow to write remote FS cache on all write operations. Add system.remote_filesystem_cache table. Add drop remote filesystem cache query. Add introspection for s3 metadata with system.remote_data_paths table. Closes #34021. Add cache option for merges by adding mode read_from_filesystem_cache_if_exists_otherwise_bypass_cache (turned on by default for merges and can also be turned on by query setting with the same name). Rename cache related settings (remote_fs_enable_cache -> enable_filesystem_cache, etc). #35475 (Kseniia Sumarokova).
  • An option to store parts metadata in RocksDB. Speed up parts loading process of MergeTree to accelerate starting up of clickhouse-server. With this improvement, clickhouse-server was able to decrease starting up time from 75 minutes to 20 seconds, with 700k mergetree parts. #32928 (李扬).

Performance Improvement​

  • A new query plan optimization. Evaluate functions after ORDER BY when possible. As an example, for a query SELECT sipHash64(number) FROM numbers(1e8) ORDER BY number LIMIT 5, function sipHash64 would be evaluated after ORDER BY and LIMIT, which gives ~20x speed up. #35623 (Nikita Taranov).
  • Sizes of hash tables used during aggregation now collected and used in later queries to avoid hash tables resizes. #33439 (Nikita Taranov).
  • Improvement for hasAll function using SIMD instructions (SSE and AVX2). #27653 (youennL-cs). #35723 (Maksim Kita).
  • Multiple changes to improve ASOF JOIN performance (1.2 - 1.6x as fast). It also adds support to use big integers. #34733 (Raúl Marín).
  • Improve performance of ASOF JOIN if key is native integer. #35525 (Maksim Kita).
  • Parallelization of multipart upload into S3 storage. #35343 (Sergei Trifonov).
  • URL storage engine now downloads multiple chunks in parallel if the endpoint supports HTTP Range. Two additional settings were added, max_download_threads and max_download_buffer_size, which control maximum number of threads a single query can use to download the file and the maximum number of bytes each thread can process. #35150 (Antonio Andelic).
  • Use multiple threads to download objects from S3. Downloading is controllable using max_download_threads and max_download_buffer_size settings. #35571 (Antonio Andelic).
  • Narrow mutex scope when interacting with HDFS. Related to #35292. #35646 (shuchaome).
  • Require mutations for per-table TTL only when it had been changed. #35953 (Azat Khuzhin).

Improvement​

  • Multiple improvements for schema inference. Use some tweaks and heuristics to determine numbers, strings, arrays, tuples and maps in CSV, TSV and TSVRaw data formats. Add setting input_format_csv_use_best_effort_in_schema_inference for CSV format that enables/disables using these heuristics, if it's disabled, we treat everything as string. Add similar setting input_format_tsv_use_best_effort_in_schema_inference for TSV/TSVRaw format. These settings are enabled by default. - Add Maps support for schema inference in Values format. - Fix possible segfault in schema inference in Values format. - Allow to skip columns with unsupported types in Arrow/ORC/Parquet formats. Add corresponding settings for it: input_format_{parquet|orc|arrow}_skip_columns_with_unsupported_types_in_schema_inference. These settings are disabled by default. - Allow to convert a column with type Null to a Nullable column with all NULL values in Arrow/Parquet formats. - Allow to specify column names in schema inference via setting column_names_for_schema_inference for formats that don't contain column names (like CSV, TSV, JSONCompactEachRow, etc) - Fix schema inference in ORC/Arrow/Parquet formats in terms of working with Nullable columns. Previously all inferred types were not Nullable and it blocked reading Nullable columns from data, now it's fixed and all inferred types are always Nullable (because we cannot understand that column is Nullable or not by reading the schema). - Fix schema inference in Template format with CSV escaping rules. #35582 (Kruglov Pavel).
  • Add parallel parsing and schema inference for format JSONAsObject. #35592 (Anton Popov).
  • Added a support for automatic schema inference to s3Cluster table function. Synced the signatures of s3 and s3Cluster. #35544 (Nikita Mikhaylov).
  • Added support for schema inference for hdfsCluster. #35602 (Nikita Mikhaylov).
  • Add new setting input_format_json_read_bools_as_numbers that allows to infer and parse bools as numbers in JSON input formats. It's enabled by default. Suggested by @alexey-milovidov. #35735 (Kruglov Pavel).
  • Improve columns ordering in schema inference for formats TSKV and JSONEachRow, closes #35640. Don't stop schema inference when reading empty row in schema inference for formats TSKV and JSONEachRow. #35724 (Kruglov Pavel).
  • Add settings input_format_orc_case_insensitive_column_matching, input_format_arrow_case_insensitive_column_matching, and input_format_parquet_case_insensitive_column_matching which allows ClickHouse to use case insensitive matching of columns while reading data from ORC, Arrow or Parquet files. #35459 (Antonio Andelic).
  • Added is_secure column to system.query_log which denotes if the client is using a secure connection over TCP or HTTP. #35705 (Antonio Andelic).
  • Now kafka_num_consumers can be bigger than amount of physical cores in case of low resource machine (less than 16 cores). #35926 (alesapin).
  • Add some basic metrics to monitor engine=Kafka tables. #35916 (filimonov).
  • Now it's not allowed to ALTER TABLE ... RESET SETTING for non-existing settings for MergeTree engines family. Fixes #35816. #35884 (alesapin).
  • Now some ALTER MODIFY COLUMN queries for Arrays and Nullable types can be done at metadata level without mutations. For example, alter from Array(Enum8('Option1'=1)) to Array(Enum8('Option1'=1, 'Option2'=2)). #35882 (alesapin).
  • Added an animation to the hourglass icon to indicate to the user that a query is running. #35860 (peledni).
  • support ALTER TABLE t DETACH PARTITION (ALL). #35794 (awakeljw).
  • Improve projection analysis to optimize trivial queries such as count(). #35788 (Amos Bird).
  • Support schema inference for insert select with using input table function. Get schema from insertion table instead of inferring it from the data in case of insert select from table functions that support schema inference. Closes #35639. #35760 (Kruglov Pavel).
  • Respect remote_url_allow_hosts for Hive tables. #35743 (李扬).
  • Implement send_logs_level for clickhouse-local. Closes #35653. #35716 (Kseniia Sumarokova).
  • Closes #35641 Allow EPHEMERAL columns without explicit default expression. #35706 (Yakov Olkhovskiy).
  • Add profile event counter AsyncInsertBytes about size of async INSERTs. #35644 (Alexey Milovidov).
  • Improve the pipeline description for JOIN. #35612 (何李夫).
  • Deduce absolute hdfs config path. #35572 (李扬).
  • Improve pasting performance and compatibility of clickhouse-client. This helps #35501. #35541 (Amos Bird).
  • It was possible to get stack overflow in distributed queries if one of the settings async_socket_for_remote and use_hedged_requests is enabled while parsing very deeply nested data type (at least in debug build). Closes #35509. #35524 (Kruglov Pavel).
  • Add sizes of subcolumns to system.parts_columns table. #35488 (Anton Popov).
  • Add explicit table info to the scan node of query plan and pipeline. #35460 (何李夫).
  • Allow server to bind to low-numbered ports (e.g. 443). ClickHouse installation script will set cap_net_bind_service to the binary file. #35451 (Alexey Milovidov).
  • Fix INSERT INTO table FROM INFILE: it did not display the progress bar. #35429 (xiedeyantu).
  • Add arguments --user, --password, --host, --port for clickhouse-diagnostics tool. #35422 (李扬).
  • Support uuid for Postgres engines. Closes #35384. #35403 (Kseniia Sumarokova).
  • For table function s3cluster or HDFSCluster or hive, we can't get right AccessType by StorageFactory::instance().getSourceAccessType(getStorageTypeName()). This pr fix it. #35365 (李扬).
  • Remove --testmode option for clickhouse-client, enable it unconditionally. #35354 (Kseniia Sumarokova).
  • Don't allow wchc operation (four letter command) for clickhouse-keeper. #35320 (zhangyuli1).
  • Add function getTypeSerializationStreams. For a specified type (which is detected from column), it returns an array with all the serialization substream paths. This function is useful mainly for developers. #35290 (李扬).
  • If port is not specified in cluster configuration, default server port will be used. This closes #34769. #34772 (Alexey Milovidov).
  • Use minmax index for orc/parquet file in Hive Engine. Related PR: https://github.com/ClickHouse/arrow/pull/10. #34631 (李扬).
  • System log tables now allow to specify COMMENT in ENGINE declaration. Closes #33768. #34536 (Maksim Kita).
  • Proper support of setting max_rows_to_read in case of reading in order of sorting key and specified limit. Previously the exception Limit for rows or bytes to read exceeded could be thrown even if query actually requires to read less amount of rows. #33230 (Anton Popov).
  • Respect only quota & period from cgroups, ignore shares (which are not really limit the number of the cores which can be used). #35815 (filimonov).

Build/Testing/Packaging Improvement​

  • Add next batch of randomization settings in functional tests. #35047 (Kruglov Pavel).
  • Add backward compatibility check in stress test. Closes #25088. #27928 (Kruglov Pavel).
  • Migrate package building to nfpm - Deprecate release script in favor of packages/build - Build everything in clickhouse/binary-builder image (cleanup: clickhouse/deb-builder) - Add symbol stripping to cmake (todo: use prefix/lib/prefix/lib/bin_dir/clickhouse/$binary.debug) - Fix issue with DWARF symbols - Add Alpine APK packages - Rename alien to additional_pkgs. #33664 (Mikhail f. Shiryaev).
  • Add a night scan and upload for Coverity. #34895 (Boris Kuschel).
  • A dedicated small package for clickhouse-keeper. #35308 (Mikhail f. Shiryaev).
  • Running with podman was failing: it complains about specifying the same volume twice. #35978 (Roman Nikonov).
  • Minor improvement in contrib/krb5 build configuration. #35832 (Anton Kozlov).
  • Add a label to recognize a building task for every image. #35583 (Mikhail f. Shiryaev).
  • Apply black formatter to python code and add a per-commit check. #35466 (Mikhail f. Shiryaev).
  • Redo alpine image to use clean Dockerfile. Create a script in tests/ci to build both ubuntu and alpine images. Add clickhouse-keeper image (cc @nikitamikhaylov). Add build check to PullRequestCI. Add a job to a ReleaseCI. Add a job to MasterCI to build and push clickhouse/clickhouse-server:head and clickhouse/clickhouse-keeper:head images for each merged PR. #35211 (Mikhail f. Shiryaev).
  • Fix stress-test report in CI, now we upload the runlog with information about started stress tests only once. #35093 (Mikhail f. Shiryaev).
  • Switch to libcxx / libcxxabi from LLVM 14. #34906 (Raúl Marín).
  • Update unixodbc to mitigate CVE-2018-7485. Note: this CVE is not relevant for ClickHouse as it implements its own isolation layer for ODBC. #35943 (Mikhail f. Shiryaev).

Bug Fix​

  • Added settings input_format_ipv4_default_on_conversion_error, input_format_ipv6_default_on_conversion_error to allow insert of invalid ip address values as default into tables. Closes #35726. #35733 (Maksim Kita).
  • Avoid erasing columns from a block if it doesn't exist while reading data from Hive. #35393 (lgbo).
  • Add type checking when creating materialized view. Close: #23684. #24896 (hexiaoting).
  • Fix formatting of INSERT INFILE queries (missing quotes). #35886 (Azat Khuzhin).
  • Disable session_log because memory safety issue has been found by fuzzing. See #35714. #35873 (Alexey Milovidov).
  • Avoid processing per-column TTL multiple times. #35820 (Azat Khuzhin).
  • Fix inserts to columns of type Object in case when there is data related to several partitions in insert query. #35806 (Anton Popov).
  • Fix bug in indexes of not presented columns in -WithNames formats that led to error INCORRECT_NUMBER_OF_COLUMNS when the number of columns is more than 256. Closes #35793. #35803 (Kruglov Pavel).
  • Fixes #35751. #35799 (Nikolay Degterinsky).
  • Fix for reading from HDFS in Snappy format. #35771 (shuchaome).
  • Fix bug in conversion from custom types to string that could lead to segfault or unexpected error messages. Closes #35752. #35755 (Kruglov Pavel).
  • Fix any/all (subquery) implementation. Closes #35489. #35727 (Kseniia Sumarokova).
  • Fix dropping non-empty database in clickhouse-local. Closes #35692. #35711 (Kseniia Sumarokova).
  • Fix bug in creating materialized view with subquery after server restart. Materialized view was not getting updated after inserts into underlying table after server restart. Closes #35511. #35691 (Kruglov Pavel).
  • Fix possible Can't adjust last granule exception while reading subcolumns of experimental type Object. #35687 (Anton Popov).
  • Enable build with JIT compilation by default. #35683 (Maksim Kita).
  • Fix possible loss of subcolumns in experimental type Object. #35682 (Anton Popov).
  • Fix check ASOF JOIN key nullability, close #35565. #35674 (Vladimir C).
  • Fix part checking logic for parts with projections. Error happened when projection and main part had different types. This is similar to https://github.com/ClickHouse/ClickHouse/pull/33774 . The bug is addressed by @caoyang10. #35667 (Amos Bird).
  • Fix server crash when large number of arguments are passed into format function. Please refer to the test file and see how to reproduce the crash. #35651 (Amos Bird).
  • Fix usage of quotas with asynchronous inserts. #35645 (Anton Popov).
  • Fix positional arguments with aliases. Closes #35600. #35620 (Kseniia Sumarokova).
  • Check remote_url_allow_hosts before schema inference in URL engine Closes #35064. #35619 (Kruglov Pavel).
  • Fix HashJoin when columns with LowCardinality type are used. This closes #35548. #35616 (Antonio Andelic).
  • Fix possible segfault in MaterializedPostgreSQL which happened if exception occurred when data, collected in memory, was synced into underlying tables. Closes #35611. #35614 (Kseniia Sumarokova).
  • Setting database_atomic_wait_for_drop_and_detach_synchronously worked incorrectly for ATTACH TABLE query when previously detached table is still in use, It's fixed. #35594 (tavplubix).
  • Fix HTTP headers with named collections, add compression_method. Closes #35273. Closes #35269. #35593 (Kseniia Sumarokova).
  • Fix s3 engine getting virtual columns. Closes #35411. #35586 (Kseniia Sumarokova).
  • Fixed return type deduction for caseWithExpression. The type of the ELSE branch is now correctly taken into account. #35576 (Antonio Andelic).
  • Fix parsing of IPv6 addresses longer than 39 characters. Closes #34022. #35539 (Maksim Kita).
  • Fix cast into IPv4, IPv6 address in IN section. Fixes #35528. #35534 (Maksim Kita).
  • Fix crash during short circuit function evaluation when one of arguments is nullable constant. Closes #35497. Closes #35496. #35502 (Maksim Kita).
  • Fix crash for function throwIf with constant arguments. #35500 (Maksim Kita).
  • Fix bug in Keeper which can lead to unstable client connections. Introduced in #35031. #35498 (alesapin).
  • Fix bug in function if when resulting column type differs with resulting data type that led to logical errors like Logical error: 'Bad cast from type DB::ColumnVector<int> to DB::ColumnVector<long>'.. Closes #35367. #35476 (Kruglov Pavel).
  • Fix excessive logging when using S3 as backend for MergeTree or as separate table engine/function. Fixes #30559. #35434 (alesapin).
  • Now merges executed with zero copy replication (experimental) will not spam logs with message Found parts with the same min block and with the same max block as the missing part _ on replica _. Hoping that it will eventually appear as a result of a merge.. #35430 (alesapin).
  • Skip possible exception if empty chunks appear in GroupingAggregatedTransform. #35417 (Nikita Taranov).
  • Fix working with columns that are not needed in query in Arrow/Parquet/ORC formats, it prevents possible errors like Unsupported <format> type <type> of an input column <column_name> when file contains column with unsupported type and we don't use it in query. #35406 (Kruglov Pavel).
  • Fix for local cache for remote filesystem (experimental feature) for high concurrency on corner cases. #35381 (Kseniia Sumarokova). Fix possible deadlock in cache. #35378 (Kseniia Sumarokova).
  • Fix partition pruning in case of comparison with constant in WHERE. If column and constant had different types, overflow was possible. Query could return an incorrect empty result. This fixes #35304. #35334 (Amos Bird).
  • Fix schema inference for TSKV format while using small max_read_buffer_size. #35332 (Kruglov Pavel).
  • Fix mutations in tables with enabled sparse columns. #35284 (Anton Popov).
  • Do not delay final part writing by default (fixes possible Memory limit exceeded during INSERT by adding max_insert_delayed_streams_for_parallel_write with default to 1000 for writes to s3 and disabled as before otherwise). #34780 (Azat Khuzhin).

ClickHouse release v22.3-lts, 2022-03-17​

Backward Incompatible Change​

  • Make arrayCompact function behave as other higher-order functions: perform compaction not of lambda function results but on the original array. If you're using nontrivial lambda functions in arrayCompact you may restore old behaviour by wrapping arrayCompact arguments into arrayMap. Closes #34010 #18535 #14778. #34795 (Alexandre Snarskii).
  • Change implementation specific behavior on overflow of function toDatetime. It will be saturated to the nearest min/max supported instant of datetime instead of wraparound. This change is highlighted as "backward incompatible" because someone may unintentionally rely on the old behavior. #32898 (HaiBo Li).
  • Make function cast(value, 'IPv4'), cast(value, 'IPv6') behave same as toIPv4, toIPv6 functions. Changed behavior of incorrect IP address passed into functions toIPv4, toIPv6, now if invalid IP address passes into this functions exception will be raised, before this function return default value. Added functions IPv4StringToNumOrDefault, IPv4StringToNumOrNull, IPv6StringToNumOrDefault, IPv6StringOrNull toIPv4OrDefault, toIPv4OrNull, toIPv6OrDefault, toIPv6OrNull. Functions IPv4StringToNumOrDefault , toIPv4OrDefault , toIPv6OrDefault should be used if previous logic relied on IPv4StringToNum, toIPv4, toIPv6 returning default value for invalid address. Added setting cast_ipv4_ipv6_default_on_conversion_error, if this setting enabled, then IP address conversion functions will behave as before. Closes #22825. Closes #5799. Closes #35156. #35240 (Maksim Kita).

New Feature​

  • Support for caching data locally for remote filesystems. It can be enabled for s3 disks. Closes #28961. #33717 (Kseniia Sumarokova). In the meantime, we enabled the test suite on s3 filesystem and no more known issues exist, so it is started to be production ready.
  • Add new table function hive. It can be used as follows hive('<hive metastore url>', '<hive database>', '<hive table name>', '<columns definition>', '<partition columns>') for example SELECT * FROM hive('thrift://hivetest:9083', 'test', 'demo', 'id Nullable(String), score Nullable(Int32), day Nullable(String)', 'day'). #34946 (lgbo).
  • Support authentication of users connected via SSL by their X.509 certificate. #31484 (eungenue).
  • Support schema inference for inserting into table functions file/hdfs/s3/url. #34732 (Kruglov Pavel).
  • Now you can read system.zookeeper table without restrictions on path or using like expression. This reads can generate quite heavy load for zookeeper so to enable this ability you have to enable setting allow_unrestricted_reads_from_keeper. #34609 (Sergei Trifonov).
  • Display CPU and memory metrics in clickhouse-local. Close #34545. #34605 (李扬).
  • Implement startsWith and endsWith function for arrays, closes #33982. #34368 (usurai).
  • Add three functions for Map data type: 1. mapReplace(map1, map2) - replaces values for keys in map1 with the values of the corresponding keys in map2; adds keys from map2 that don't exist in map1. 2. mapFilter 3. mapMap. mapFilter and mapMap are higher order functions, accepting two arguments, the first argument is a lambda function with k, v pair as arguments, the second argument is a column of type Map. #33698 (hexiaoting).
  • Allow getting default user and password for clickhouse-client from the CLICKHOUSE_USER and CLICKHOUSE_PASSWORD environment variables. Close #34538. #34947 (DR).

Experimental Feature​

  • New data type Object(<schema_format>), which supports storing of semi-structured data (for now JSON only). Data is written to such types as string. Then all paths are extracted according to format of semi-structured data and written as separate columns in most optimal types, that can store all their values. Those columns can be queried by names that match paths in source data. E.g data.key1.key2 or with cast operator data.key1.key2::Int64.
  • Add database_replicated_allow_only_replicated_engine setting. When enabled, it only allowed to only create Replicated tables or tables with stateless engines in Replicated databases. #35214 (Nikolai Kochetov). Note that Replicated database is still an experimental feature.

Performance Improvement​

  • Improve performance of insertion into MergeTree tables by optimizing sorting. Up to 2x improvement is observed on realistic benchmarks. #34750 (Maksim Kita).
  • Columns pruning when reading Parquet, ORC and Arrow files from URL and S3. Closes #34163. #34849 (Kseniia Sumarokova).
  • Columns pruning when reading Parquet, ORC and Arrow files from Hive. #34954 (lgbo).
  • A bunch of performance optimizations from a performance superhero. Improve performance of processing queries with large IN section. Improve performance of direct dictionary if its source is ClickHouse. Improve performance of detectCharset , detectLanguageUnknown functions. #34888 (Maksim Kita).
  • Improve performance of any aggregate function by using more batching. #34760 (Raúl Marín).
  • Multiple improvements for performance of clickhouse-keeper: less locking #35010 (zhanglistar), lower memory usage by streaming reading and writing of snapshot instead of full copy. #34584 (zhanglistar), optimizing compaction of log store in the RAFT implementation. #34534 (zhanglistar), versioning of the internal data structure #34486 (zhanglistar).

Improvement​

  • Allow asynchronous inserts to table functions. Fixes #34864. #34866 (Anton Popov).
  • Implicit type casting of the key argument for functions dictGetHierarchy, dictIsIn, dictGetChildren, dictGetDescendants. Closes #34970. #35027 (Maksim Kita).
  • EXPLAIN AST query can output AST in form of a graph in Graphviz format: EXPLAIN AST graph = 1 SELECT * FROM system.parts. #35173 (李扬).
  • When large files were written with s3 table function or table engine, the content type on the files was mistakenly set to application/xml due to a bug in the AWS SDK. This closes #33964. #34433 (Alexey Milovidov).
  • Change restrictive row policies a bit to make them an easier alternative to permissive policies in easy cases. If for a particular table only restrictive policies exist (without permissive policies) users will be able to see some rows. Also SHOW CREATE ROW POLICY will always show AS permissive or AS restrictive in row policy's definition. #34596 (Vitaly Baranov).
  • Improve schema inference with globs in File/S3/HDFS/URL engines. Try to use the next path for schema inference in case of error. #34465 (Kruglov Pavel).
  • Play UI now correctly detects the preferred light/dark theme from the OS. #35068 (peledni).
  • Added date_time_input_format = 'best_effort_us'. Closes #34799. #34982 (WenYao).
  • A new settings called allow_plaintext_password and allow_no_password are added in server configuration which turn on/off authentication types that can be potentially insecure in some environments. They are allowed by default. #34738 (Heena Bansal).
  • Support for DateTime64 data type in Arrow format, closes #8280 and closes #28574. #34561 (李扬).
  • Reload remote_url_allow_hosts (filtering of outgoing connections) on config update. #35294 (Nikolai Kochetov).
  • Support --testmode parameter for clickhouse-local. This parameter enables interpretation of test hints that we use in functional tests. #35264 (Kseniia Sumarokova).
  • Add distributed_depth to query log. It is like a more detailed variant of is_initial_query #35207 (李扬).
  • Respect remote_url_allow_hosts for MySQL and PostgreSQL table functions. #35191 (Heena Bansal).
  • Added disk_name field to system.part_log. #35178 (Artyom Yurkov).
  • Do not retry non-rertiable errors when querying remote URLs. Closes #35161. #35172 (Kseniia Sumarokova).
  • Support distributed INSERT SELECT queries (the setting parallel_distributed_insert_select) table function view(). #35132 (Azat Khuzhin).
  • More precise memory tracking during INSERT into Buffer with AggregateFunction. #35072 (Azat Khuzhin).
  • Avoid division by zero in Query Profiler if Linux kernel has a bug. Closes #34787. #35032 (Alexey Milovidov).
  • Add more sanity checks for keeper configuration: now mixing of localhost and non-local servers is not allowed, also add checks for same value of internal raft port and keeper client port. #35004 (alesapin).
  • Currently, if the user changes the settings of the system tables there will be tons of logs and ClickHouse will rename the tables every minute. This fixes #34929. #34949 (Nikita Mikhaylov).
  • Use connection pool for Hive metastore client. #34940 (lgbo).
  • Ignore per-column TTL in CREATE TABLE AS if new table engine does not support it (i.e. if the engine is not of MergeTree family). #34938 (Azat Khuzhin).
  • Allow LowCardinality strings for ngrambf_v1/tokenbf_v1 indexes. Closes #21865. #34911 (Lars Hiller Eidnes).
  • Allow opening empty sqlite db if the file doesn't exist. Closes #33367. #34907 (Kseniia Sumarokova).
  • Implement memory statistics for FreeBSD - this is required for max_server_memory_usage to work correctly. #34902 (Alexandre Snarskii).
  • In previous versions the progress bar in clickhouse-client can jump forward near 50% for no reason. This closes #34324. #34801 (Alexey Milovidov).
  • Now ALTER TABLE DROP COLUMN columnX queries for MergeTree table engines will work instantly when columnX is an ALIAS column. Fixes #34660. #34786 (alesapin).
  • Show hints when user mistyped the name of a data skipping index. Closes #29698. #34764 (flynn).
  • Support remote()/cluster() table functions for parallel_distributed_insert_select. #34728 (Azat Khuzhin).
  • Do not reset logging that configured via --log-file/--errorlog-file command line options in case of empty configuration in the config file. #34718 (Amos Bird).
  • Extract schema only once on table creation and prevent reading from local files/external sources to extract schema on each server startup. #34684 (Kruglov Pavel).
  • Allow specifying argument names for executable UDFs. This is necessary for formats where argument name is part of serialization, like Native, JSONEachRow. Closes #34604. #34653 (Maksim Kita).
  • MaterializedMySQL (experimental feature) now supports materialized_mysql_tables_list (a comma-separated list of MySQL database tables, which will be replicated by the MaterializedMySQL database engine. Default value: empty list — means all the tables will be replicated), mentioned at #32977. #34487 (zzsmdfj).
  • Improve OpenTelemetry span logs for INSERT operation on distributed table. #34480 (Frank Chen).
  • Make the znode ctime and mtime consistent between servers in ClickHouse Keeper. #33441 (小路).

Build/Testing/Packaging Improvement​

  • Package repository is migrated to JFrog Artifactory (Mikhail f. Shiryaev).
  • Randomize some settings in functional tests, so more possible combinations of settings will be tested. This is yet another fuzzing method to ensure better test coverage. This closes #32268. #34092 (Kruglov Pavel).
  • Drop PVS-Studio from our CI. #34680 (Mikhail f. Shiryaev).
  • Add an ability to build stripped binaries with CMake. In previous versions it was performed by dh-tools. #35196 (alesapin).
  • Smaller "fat-free" clickhouse-keeper build. #35031 (alesapin).
  • Use @robot-clickhouse as an author and committer for PRs like https://github.com/ClickHouse/ClickHouse/pull/34685. #34793 (Mikhail f. Shiryaev).
  • Limit DWARF version for debug info by 4 max, because our internal stack symbolizer cannot parse DWARF version 5. This makes sense if you compile ClickHouse with clang-15. #34777 (Alexey Milovidov).
  • Remove clickhouse-test debian package as unneeded complication. CI use tests from repository and standalone testing via deb package is no longer supported. #34606 (Ilya Yatsishin).

Bug Fix (user-visible misbehaviour in official stable or prestable release)​

  • A fix for HDFS integration: When the inner buffer size is too small, NEED_MORE_INPUT in HadoopSnappyDecoder will run multi times (>=3) for one compressed block. This makes the input data be copied into the wrong place in HadoopSnappyDecoder::buffer. #35116 (lgbo).
  • Ignore obsolete grants in ATTACH GRANT statements. This PR fixes #34815. #34855 (Vitaly Baranov).
  • Fix segfault in Postgres database when getting create table query if database was created using named collections. Closes #35312. #35313 (Kseniia Sumarokova).
  • Fix partial merge join duplicate rows bug, close #31009. #35311 (Vladimir C).
  • Fix possible Assertion 'position() != working_buffer.end()' failed while using bzip2 compression with small max_read_buffer_size setting value. The bug was found in https://github.com/ClickHouse/ClickHouse/pull/35047. #35300 (Kruglov Pavel). While using lz4 compression with a small max_read_buffer_size setting value. #35296 (Kruglov Pavel). While using lzma compression with small max_read_buffer_size setting value. #35295 (Kruglov Pavel). While using brotli compression with a small max_read_buffer_size setting value. The bug was found in https://github.com/ClickHouse/ClickHouse/pull/35047. #35281 (Kruglov Pavel).
  • Fix possible segfault in JSONEachRow schema inference. #35291 (Kruglov Pavel).
  • Fix CHECK TABLE query in case when sparse columns are enabled in table. #35274 (Anton Popov).
  • Avoid std::terminate in case of exception in reading from remote VFS. #35257 (Azat Khuzhin).
  • Fix reading port from config, close #34776. #35193 (Vladimir C).
  • Fix error in query with WITH TOTALS in case if HAVING returned empty result. This fixes #33711. #35186 (Amos Bird).
  • Fix a corner case of replaceRegexpAll, close #35117. #35182 (Vladimir C).
  • Schema inference didn't work properly on case of INSERT INTO FUNCTION s3(...) FROM ..., it tried to read schema from s3 file instead of from select query. #35176 (Kruglov Pavel).
  • Fix MaterializedPostgreSQL (experimental feature) table overrides for partition by, etc. Closes #35048. #35162 (Kseniia Sumarokova).
  • Fix MaterializedPostgreSQL (experimental feature) adding new table to replication (ATTACH TABLE) after manually removing (DETACH TABLE). Closes #33800. Closes #34922. Closes #34315. #35158 (Kseniia Sumarokova).
  • Fix partition pruning error when non-monotonic function is used with IN operator. This fixes #35136. #35146 (Amos Bird).
  • Fixed slightly incorrect translation of YAML configs to XML. #35135 (Miel Donkers).
  • Fix optimize_skip_unused_shards_rewrite_in for signed columns and negative values. #35134 (Azat Khuzhin).
  • The update_lag external dictionary configuration option was unusable showing the error message Unexpected key `update_lag` in dictionary source configuration. #35089 (Jason Chu).
  • Avoid possible deadlock on server shutdown. #35081 (Azat Khuzhin).
  • Fix missing alias after function is optimized to a subcolumn when setting optimize_functions_to_subcolumns is enabled. Closes #33798. #35079 (qieqieplus).
  • Fix reading from system.asynchronous_inserts table if there exists asynchronous insert into table function. #35050 (Anton Popov).
  • Fix possible exception Reading for MergeTree family tables must be done with last position boundary (relevant to operation on remote VFS). Closes #34979. #35001 (Kseniia Sumarokova).
  • Fix unexpected result when use -State type aggregate function in window frame. #34999 (metahys).
  • Fix possible segfault in FileLog (experimental feature). Closes #30749. #34996 (Kseniia Sumarokova).
  • Fix possible rare error Cannot push block to port which already has data. #34993 (Nikolai Kochetov).
  • Fix wrong schema inference for unquoted dates in CSV. Closes #34768. #34961 (Kruglov Pavel).
  • Integration with Hive: Fix unexpected result when use in in where in hive query. #34945 (lgbo).
  • Avoid busy polling in ClickHouse Keeper while searching for changelog files to delete. #34931 (Azat Khuzhin).
  • Fix DateTime64 conversion from PostgreSQL. Closes #33364. #34910 (Kseniia Sumarokova).
  • Fix possible "Part directory doesn't exist" during INSERT into MergeTree table backed by VFS over s3. #34876 (Azat Khuzhin).
  • Support DDLs like CREATE USER to be executed on cross replicated cluster. #34860 (Jianmei Zhang).
  • Fix bugs for multiple columns group by in WindowView (experimental feature). #34859 (vxider).
  • Fix possible failures in S2 functions when queries contain const columns. #34745 (Bharat Nallan).
  • Fix bug for H3 funcs containing const columns which cause queries to fail. #34743 (Bharat Nallan).
  • Fix No such file or directory with enabled fsync_part_directory and vertical merge. #34739 (Azat Khuzhin).
  • Fix serialization/printing for system queries RELOAD MODEL, RELOAD FUNCTION, RESTART DISK when used ON CLUSTER. Closes #34514. #34696 (Maksim Kita).
  • Fix allow_experimental_projection_optimization with enable_global_with_statement (before it may lead to Stack size too large error in case of multiple expressions in WITH clause, and also it executes scalar subqueries again and again, so not it will be more optimal). #34650 (Azat Khuzhin).
  • Stop to select part for mutate when the other replica has already updated the transaction log for ReplatedMergeTree engine. #34633 (Jianmei Zhang).
  • Fix incorrect result of trivial count query when part movement feature is used #34089. #34385 (nvartolomei).
  • Fix inconsistency of max_query_size limitation in distributed subqueries. #34078 (Chao Ma).

ClickHouse release v22.2, 2022-02-17​

Upgrade Notes​

  • Applying data skipping indexes for queries with FINAL may produce incorrect result. In this release we disabled data skipping indexes by default for queries with FINAL (a new setting use_skip_indexes_if_final is introduced and disabled by default). #34243 (Azat Khuzhin).

New Feature​

  • Projections are production ready. Set allow_experimental_projection_optimization by default and deprecate this setting. #34456 (Nikolai Kochetov).
  • An option to create a new files on insert for File/S3/HDFS engines. Allow to overwrite a file in HDFS. Throw an exception in attempt to overwrite a file in S3 by default. Throw an exception in attempt to append data to file in formats that have a suffix (and thus don't support appends, like Parquet, ORC). Closes #31640 Closes #31622 Closes #23862 Closes #15022 Closes #16674. #33302 (Kruglov Pavel).
  • Add a setting that allows a user to provide own deduplication semantic in MergeTree/ReplicatedMergeTree If provided, it's used instead of data digest to generate block ID. So, for example, by providing a unique value for the setting in each INSERT statement, the user can avoid the same inserted data being deduplicated. This closes: #7461. #32304 (Igor Nikonov).
  • Add support of DEFAULT keyword for INSERT statements. Closes #6331. #33141 (Andrii Buriachevskyi).
  • EPHEMERAL column specifier is added to CREATE TABLE query. Closes #9436. #34424 (yakov-olkhovskiy).
  • Support IF EXISTS clause for TTL expr TO [DISK|VOLUME] [IF EXISTS] 'xxx' feature. Parts will be moved to disk or volume only if it exists on replica, so MOVE TTL rules will be able to behave differently on replicas according to the existing storage policies. Resolves #34455. #34504 (Anton Popov).
  • Allow set default table engine and to create tables without specifying ENGINE. #34187 (Ilya Yatsishin).
  • Add table function format(format_name, data). #34125 (Kruglov Pavel).
  • Detect format in clickhouse-local by file name even in the case when it is passed to stdin. #33829 (Kruglov Pavel).
  • Add schema inference for values table function. Closes #33811. #34017 (Kruglov Pavel).
  • Dynamic reload of server TLS certificates on config reload. Closes #15764. #15765 (johnskopis). #31257 (Filatenkov Artur).
  • Now ReplicatedMergeTree can recover data when some of its disks are broken. #13544 (Amos Bird).
  • Fault-tolerant connections in clickhouse-client: clickhouse-client ... --host host1 --host host2 --port port2 --host host3 --port port --host host4. #34490 (Kruglov Pavel). #33824 (Filippov Denis).
  • Add DEGREES and RADIANS functions for MySQL compatibility. #33769 (Bharat Nallan).
  • Add h3ToCenterChild function. #33313 (Bharat Nallan). Add new h3 miscellaneous functions: edgeLengthKm,exactEdgeLengthKm,exactEdgeLengthM,exactEdgeLengthRads,numHexagons. #33621 (Bharat Nallan).
  • Add function bitSlice to extract bit subsequences from String/FixedString. #33360 (RogerYK).
  • Implemented meanZTest aggregate function. #33354 (achimbab).
  • Add confidence intervals to T-tests aggregate functions. #33260 (achimbab).
  • Add function addressToLineWithInlines. Close #26211. #33467 (SuperDJY).
  • Added #! and # as a recognised start of a single line comment. Closes #34138. #34230 (Aaron Katz).

Experimental Feature​

  • Functions for text classification: language and charset detection. See #23271. #33314 (Nikolay Degterinsky).
  • Add memory overcommit to MemoryTracker. Added guaranteed settings for memory limits which represent soft memory limits. In case when hard memory limit is reached, MemoryTracker tries to cancel the most overcommited query. New setting memory_usage_overcommit_max_wait_microseconds specifies how long queries may wait another query to stop. Closes #28375. #31182 (Dmitry Novik).
  • Enable stream to table join in WindowView. #33729 (vxider).
  • Support SET, YEAR, TIME and GEOMETRY data types in MaterializedMySQL (experimental feature). Fixes #18091, #21536, #26361. #33429 (zzsmdfj).
  • Fix various issues when projection is enabled by default. Each issue is described in separate commit. This is for #33678 . This fixes #34273. #34305 (Amos Bird).

Performance Improvement​

  • Support optimize_read_in_order if prefix of sorting key is already sorted. E.g. if we have sorting key ORDER BY (a, b) in table and query with WHERE a = const ORDER BY b clauses, now it will be applied reading in order of sorting key instead of full sort. #32748 (Anton Popov).
  • Improve performance of partitioned insert into table functions URL, S3, File, HDFS. Closes #34348. #34510 (Maksim Kita).
  • Multiple performance improvements of clickhouse-keeper. #34484 #34587 (zhanglistar).
  • FlatDictionary improve performance of dictionary data load. #33871 (Maksim Kita).
  • Improve performance of mapPopulateSeries function. Closes #33944. #34318 (Maksim Kita).
  • _file and _path virtual columns (in file-like table engines) are made LowCardinality - it will make queries for multiple files faster. Closes #34300. #34317 (flynn).
  • Speed up loading of data parts. It was not parallelized before: the setting part_loading_threads did not have effect. See #4699. #34310 (alexey-milovidov).
  • Improve performance of LineAsString format. This closes #34303. #34306 (alexey-milovidov).
  • Optimize quantilesExact{Low,High} to use nth_element instead of sort. #34287 (Danila Kutenin).
  • Slightly improve performance of Regexp format. #34202 (alexey-milovidov).
  • Minor improvement for analysis of scalar subqueries. #34128 (Federico Rodriguez).
  • Make ORDER BY tuple almost as fast as ORDER BY columns. We have special optimizations for multiple column ORDER BY: https://github.com/ClickHouse/ClickHouse/pull/10831 . It's beneficial to also apply to tuple columns. #34060 (Amos Bird).
  • Rework and reintroduce the scalar subqueries cache to Materialized Views execution. #33958 (Raúl Marín).
  • Slightly improve performance of ORDER BY by adding x86-64 AVX-512 support for memcmpSmall functions to accelerate memory comparison. It works only if you compile ClickHouse by yourself. #33706 (hanqf-git).
  • Improve range_hashed dictionary performance if for key there are a lot of intervals. Fixes #23821. #33516 (Maksim Kita).
  • For inserts and merges into S3, write files in parallel whenever possible (TODO: check if it's merged). #33291 (Nikolai Kochetov).
  • Improve clickhouse-keeper performance and fix several memory leaks in NuRaft library. #33329 (alesapin).

Improvement​

  • Support asynchronous inserts in clickhouse-client for queries with inlined data. #34267 (Anton Popov).
  • Functions dictGet, dictHas implicitly cast key argument to dictionary key structure, if they are different. #33672 (Maksim Kita).
  • Improvements for range_hashed dictionaries. Improve performance of load time if there are multiple attributes. Allow to create a dictionary without attributes. Added option to specify strategy when intervals start and end have Nullable type convert_null_range_bound_to_open by default is true. Closes #29791. Allow to specify Float, Decimal, DateTime64, Int128, Int256, UInt128, UInt256 as range types. RangeHashedDictionary added support for range values that extend Int64 type. Closes #28322. Added option range_lookup_strategy to specify range lookup type min, max by default is min . Closes #21647. Fixed allocated bytes calculations. Fixed type name in system.dictionaries in case of ComplexKeyHashedDictionary. #33927 (Maksim Kita).
  • flat, hashed, hashed_array dictionaries now support creating with empty attributes, with support of reading the keys and using dictHas. Fixes #33820. #33918 (Maksim Kita).
  • Added support for DateTime64 data type in dictionaries. #33914 (Maksim Kita).
  • Allow to write s3(url, access_key_id, secret_access_key) (autodetect of data format and table structure, but with explicit credentials). #34503 (Kruglov Pavel).
  • Added sending of the output format back to client like it's done in HTTP protocol as suggested in #34362. Closes #34362. #34499 (Vitaly Baranov).
  • Send ProfileEvents statistics in case of INSERT SELECT query (to display query metrics in clickhouse-client for this type of queries). #34498 (Dmitry Novik).
  • Recognize .jsonl extension for JSONEachRow format. #34496 (Kruglov Pavel).
  • Improve schema inference in clickhouse-local. Allow to write just clickhouse-local -q "select * from table" < data.format. #34495 (Kruglov Pavel).
  • Privileges CREATE/ALTER/DROP ROW POLICY now can be granted on a table or on database.* as well as globally *.*. #34489 (Vitaly Baranov).
  • Allow to export arbitrary large files to s3. Add two new settings: s3_upload_part_size_multiply_factor and s3_upload_part_size_multiply_parts_count_threshold. Now each time s3_upload_part_size_multiply_parts_count_threshold uploaded to S3 from a single query s3_min_upload_part_size multiplied by s3_upload_part_size_multiply_factor. Fixes #34244. #34422 (alesapin).
  • Allow to skip not found (404) URLs for globs when using URL storage / table function. Also closes #34359. #34392 (Kseniia Sumarokova).
  • Default input and output formats for clickhouse-local that can be overriden by --input-format and --output-format. Close #30631. #34352 (李扬).
  • Add options for clickhouse-format. Which close #30528 - max_query_size - max_parser_depth. #34349 (李扬).
  • Better handling of pre-inputs before client start. This is for #34308. #34336 (Amos Bird).
  • REGEXP_MATCHES and REGEXP_REPLACE function aliases for compatibility with PostgreSQL. Close #30885. #34334 (李扬).
  • Some servers expect a User-Agent header in their HTTP requests. A User-Agent header entry has been added to HTTP requests of the form: User-Agent: ClickHouse/VERSION_STRING. #34330 (Saad Ur Rahman).
  • Cancel merges before acquiring table lock for TRUNCATE query to avoid DEADLOCK_AVOIDED error in some cases. Fixes #34302. #34304 (tavplubix).
  • Change severity of the "Cancelled merging parts" message in logs, because it's not an error. This closes #34148. #34232 (alexey-milovidov).
  • Add ability to compose PostgreSQL-style cast operator :: with expressions using [] and . operators (array and tuple indexing). #34229 (Nikolay Degterinsky).
  • Recognize YYYYMMDD-hhmmss format in parseDateTimeBestEffort function. This closes #34206. #34208 (alexey-milovidov).
  • Allow carriage return in the middle of the line while parsing by Regexp format. This closes #34200. #34205 (alexey-milovidov).
  • Allow to parse dictionary's PRIMARY KEY as PRIMARY KEY (id, value); previously supported only PRIMARY KEY id, value. Closes #34135. #34141 (Maksim Kita).
  • An optional argument for splitByChar to limit the number of resulting elements. close #34081. #34140 (李扬).
  • Improving the experience of multiple line editing for clickhouse-client. This is a follow-up of #31123. #34114 (Amos Bird).
  • Add UUID suport in MsgPack input/output format. #34065 (Kruglov Pavel).
  • Tracing context (for OpenTelemetry) is now propagated from GRPC client metadata (this change is relevant for GRPC client-server protocol). #34064 (andremarianiello).
  • Supports all types of SYSTEM queries with ON CLUSTER clause. #34005 (小路).
  • Improve memory accounting for queries that are using less than max_untracker_memory. #34001 (Azat Khuzhin).
  • Fixed UTF-8 string case-insensitive search when lowercase and uppercase characters are represented by different number of bytes. Example is ẞ and ß. This closes #7334. #33992 (Harry Lee).
  • Detect format and schema from stdin in clickhouse-local. #33960 (Kruglov Pavel).
  • Correctly handle the case of misconfiguration when multiple disks are using the same path on the filesystem. #29072. #33905 (zhongyuankai).
  • Try every resolved IP address while getting S3 proxy. S3 proxies are rarely used, mostly in Yandex Cloud. #33862 (Nikolai Kochetov).
  • Support EXPLAIN AST CREATE FUNCTION query EXPLAIN AST CREATE FUNCTION mycast AS (n) -> cast(n as String) will return EXPLAIN AST CREATE FUNCTION mycast AS n -> CAST(n, 'String'). #33819 (李扬).
  • Added support for cast from Map(Key, Value) to Array(Tuple(Key, Value)). #33794 (Maksim Kita).
  • Add some improvements and fixes for Bool data type. Fixes #33244. #33737 (Kruglov Pavel).
  • Parse and store OpenTelemetry trace-id in big-endian order. #33723 (Frank Chen).
  • Improvement for fromUnixTimestamp64 family functions.. They now accept any integer value that can be converted to Int64. This closes: #14648. #33505 (Andrey Zvonov).
  • Reimplement _shard_num from constants (see #7624) with shardNum() function (seee #27020), to avoid possible issues (like those that had been found in #16947). #33392 (Azat Khuzhin).
  • Enable binary arithmetic (plus, minus, multiply, division, least, greatest) between Decimal and Float. #33355 (flynn).
  • Respect cgroups limits in max_threads autodetection. #33342 (JaySon).
  • Add new clickhouse-keeper setting min_session_timeout_ms. Now clickhouse-keeper will determine client session timeout according to min_session_timeout_ms and session_timeout_ms settings. #33288 (JackyWoo).
  • Added UUID data type support for functions hex and bin. #32170 (Frank Chen).
  • Fix reading of subcolumns with dots in their names. In particular fixed reading of Nested columns, if their element names contain dots (e.g Nested(`keys.name` String, `keys.id` UInt64, values UInt64)). #34228 (Anton Popov).
  • Fixes parallel_view_processing = 0 not working when inserting into a table using VALUES. - Fixes view_duration_ms in the query_views_log not being set correctly for materialized views. #34067 (Raúl Marín).
  • Fix parsing tables structure from ZooKeeper: now metadata from ZooKeeper compared with local metadata in canonical form. It helps when canonical function names can change between ClickHouse versions. #33933 (sunny).
  • Properly escape some characters for interaction with LDAP. #33401 (IlyaTsoi).

Build/Testing/Packaging Improvement​

  • Remove unbundled build support. #33690 (Azat Khuzhin).
  • Ensure that tests don't depend on the result of non-stable sorting of equal elements. Added equal items ranges randomization in debug after sort to prevent issues when we rely on equal items sort order. #34393 (Maksim Kita).
  • Add verbosity to a style check. #34289 (Mikhail f. Shiryaev).
  • Remove clickhouse-test debian package because it's obsolete. #33948 (Ilya Yatsishin).
  • Multiple improvements for build system to remove the possibility of occasionally using packages from the OS and to enforce hermetic builds. #33695 (Amos Bird).

Bug Fix (user-visible misbehaviour in official stable or prestable release)​

  • Fixed the assertion in case of using allow_experimental_parallel_reading_from_replicas with max_parallel_replicas equals to 1. This fixes #34525. #34613 (Nikita Mikhaylov).
  • Fix rare bug while reading of empty arrays, which could lead to Data compressed with different methods error. It can reproduce if you have mostly empty arrays, but not always. And reading is performed in backward direction with ORDER BY ... DESC. This error is extremely unlikely to happen. #34327 (Anton Popov).
  • Fix wrong result of round/roundBankers if integer values of small types are rounded. Closes #33267. #34562 (李扬).
  • Sometimes query cancellation did not work immediately when we were reading multiple files from s3 or HDFS. Fixes #34301 Relates to #34397. #34539 (Dmitry Novik).
  • Fix exception Chunk should have AggregatedChunkInfo in MergingAggregatedTransform (in case of optimize_aggregation_in_order = 1 and distributed_aggregation_memory_efficient = 0). Fixes #34526. #34532 (Anton Popov).
  • Fix comparison between integers and floats in index analysis. Previously it could lead to skipping some granules for reading by mistake. Fixes #34493. #34528 (Anton Popov).
  • Fix compression support in URL engine. #34524 (Frank Chen).
  • Fix possible error 'file_size: Operation not supported' in files' schema autodetection. #34479 (Kruglov Pavel).
  • Fixes possible race with table deletion. #34416 (Kseniia Sumarokova).
  • Fix possible error Cannot convert column Function to mask in short circuit function evaluation. Closes #34171. #34415 (Kruglov Pavel).
  • Fix potential crash when doing schema inference from url source. Closes #34147. #34405 (Kruglov Pavel).
  • For UDFs access permissions were checked for database level instead of global level as it should be. Closes #34281. #34404 (Maksim Kita).
  • Fix wrong engine syntax in result of SHOW CREATE DATABASE query for databases with engine Memory. This closes #34335. #34345 (alexey-milovidov).
  • Fixed a couple of extremely rare race conditions that might lead to broken state of replication queue and "intersecting parts" error. #34297 (tavplubix).
  • Fix progress bar width. It was incorrectly rounded to integer number of characters. #34275 (alexey-milovidov).
  • Fix current_user/current_address client information fields for inter-server communication (before this patch current_user/current_address will be preserved from the previous query). #34263 (Azat Khuzhin).
  • Fix memory leak in case of some Exception during query processing with optimize_aggregation_in_order=1. #34234 (Azat Khuzhin).
  • Fix metric Query, which shows the number of executing queries. In last several releases it was always 0. #34224 (Anton Popov).
  • Fix schema inference for table runction s3. #34186 (Kruglov Pavel).
  • Fix rare and benign race condition in HDFS, S3 and URL storage engines which can lead to additional connections. #34172 (alesapin).
  • Fix bug which can rarely lead to error "Cannot read all data" while reading LowCardinality columns of MergeTree table engines family which stores data on remote file system like S3 (virtual filesystem over s3 is an experimental feature that is not ready for production). #34139 (alesapin).
  • Fix inserts to distributed tables in case of a change of native protocol. The last change was in the version 22.1, so there may be some failures of inserts to distributed tables after upgrade to that version. #34132 (Anton Popov).
  • Fix possible data race in File table engine that was introduced in #33960. Closes #34111. #34113 (Kruglov Pavel).
  • Fixed minor race condition that might cause "intersecting parts" error in extremely rare cases after ZooKeeper connection loss. #34096 (tavplubix).
  • Fix asynchronous inserts with Native format. #34068 (Anton Popov).
  • Fix bug which lead to inability for server to start when both replicated access storage and keeper (embedded in clickhouse-server) are used. Introduced two settings for keeper socket timeout instead of settings from default user: keeper_server.socket_receive_timeout_sec and keeper_server.socket_send_timeout_sec. Fixes #33973. #33988 (alesapin).
  • Fix segfault while parsing ORC file with corrupted footer. Closes #33797. #33984 (Kruglov Pavel).
  • Fix parsing IPv6 from query parameter (prepared statements) and fix IPv6 to string conversion. Closes #33928. #33971 (Kruglov Pavel).
  • Fix crash while reading of nested tuples. Fixes #33838. #33956 (Anton Popov).
  • Fix usage of functions array and tuple with literal arguments in distributed queries. Previously it could lead to Not found columns exception. #33938 (Anton Popov).
  • Aggregate function combinator -If did not correctly process Nullable filter argument. This closes #27073. #33920 (alexey-milovidov).
  • Fix potential race condition when doing remote disk read (virtual filesystem over s3 is an experimental feature that is not ready for production). #33912 (Amos Bird).
  • Fix crash if SQL UDF is created with lambda with non identifier arguments. Closes #33866. #33868 (Maksim Kita).
  • Fix usage of sparse columns (which can be enabled by experimental setting ratio_of_defaults_for_sparse_serialization). #33849 (Anton Popov).
  • Fixed replica is not readonly logical error on SYSTEM RESTORE REPLICA query when replica is actually readonly. Fixes #33806. #33847 (tavplubix).
  • Fix memory leak in clickhouse-keeper in case of compression is used (default). #33840 (Azat Khuzhin).
  • Fix index analysis with no common types available. #33833 (Amos Bird).
  • Fix schema inference for JSONEachRow and JSONCompactEachRow. #33830 (Kruglov Pavel).
  • Fix usage of external dictionaries with redis source and large number of keys. #33804 (Anton Popov).
  • Fix bug in client that led to 'Connection reset by peer' in server. Closes #33309. #33790 (Kruglov Pavel).
  • Fix parsing query INSERT INTO ... VALUES SETTINGS ... (...), ... #33776 (Kruglov Pavel).
  • Fix bug of check table when creating data part with wide format and projection. #33774 (李扬).
  • Fix tiny race between count() and INSERT/merges/... in MergeTree (it is possible to return incorrect number of rows for SELECT with optimize_trivial_count_query). #33753 (Azat Khuzhin).
  • Throw exception when directory listing request has failed in storage HDFS. #33724 (LiuNeng).
  • Fix mutation when table contains projections. This fixes #33010. This fixes #33275. #33679 (Amos Bird).
  • Correctly determine current database if CREATE TEMPORARY TABLE AS SELECT is queried inside a named HTTP session. This is a very rare use case. This closes #8340. #33676 (alexey-milovidov).
  • Allow some queries with sorting, LIMIT BY, ARRAY JOIN and lambda functions. This closes #7462. #33675 (alexey-milovidov).
  • Fix bug in "zero copy replication" (a feature that is under development and should not be used in production) which lead to data duplication in case of TTL move. Fixes #33643. #33642 (alesapin).
  • Fix Chunk should have AggregatedChunkInfo in GroupingAggregatedTransform (in case of optimize_aggregation_in_order = 1). #33637 (Azat Khuzhin).
  • Fix error Bad cast from type ... to DB::DataTypeArray which may happen when table has Nested column with dots in name, and default value is generated for it (e.g. during insert, when column is not listed). Continuation of #28762. #33588 (Alexey Pavlenko).
  • Export into lz4 files has been fixed. Closes #31421. #31862 (Kruglov Pavel).
  • Fix potential crash if group_by_overflow_mode was set to any (approximate GROUP BY) and aggregation was performed by single column of type LowCardinality. #34506 (DR).
  • Fix inserting to temporary tables via gRPC client-server protocol. Fixes #34347, issue #2. #34364 (Vitaly Baranov).
  • Fix issue #19429. #34225 (Vitaly Baranov).
  • Fix issue #18206. #33977 (Vitaly Baranov).
  • This PR allows using multiple LDAP storages in the same list of user directories. It worked earlier but was broken because LDAP tests are disabled (they are part of the testflows tests). #33574 (Vitaly Baranov).

ClickHouse release v22.1, 2022-01-18​

Upgrade Notes​

  • The functions left and right were previously implemented in parser and now full-featured. Distributed queries with left or right functions without aliases may throw exception if cluster contains different versions of clickhouse-server. If you are upgrading your cluster and encounter this error, you should finish upgrading your cluster to ensure all nodes have the same version. Also you can add aliases (AS something) to the columns in your queries to avoid this issue. #33407 (alexey-milovidov).
  • Resource usage by scalar subqueries is fully accounted since this version. With this change, rows read in scalar subqueries are now reported in the query_log. If the scalar subquery is cached (repeated or called for several rows) the rows read are only counted once. This change allows KILLing queries and reporting progress while they are executing scalar subqueries. #32271 (Raúl Marín).

New Feature​

  • Implement data schema inference for input formats. Allow to skip structure (or write just auto) in table functions file, url, s3, hdfs and in parameters of clickhouse-local . Allow to skip structure in create query for table engines File, HDFS, S3, URL, Merge, Buffer, Distributed and ReplicatedMergeTree (if we add new replicas). #32455 (Kruglov Pavel).
  • Detect format by file extension in file/hdfs/s3/url table functions and HDFS/S3/URL table engines and also for SELECT INTO OUTFILE and INSERT FROM INFILE #33565 (Kruglov Pavel). Close #30918. #33443 (OnePiece).
  • A tool for collecting diagnostics data if you need support. #33175 (Alexander Burmak).
  • Automatic cluster discovery via Zoo/Keeper. It allows to add replicas to the cluster without changing configuration on every server. #31442 (vdimir).
  • Implement hive table engine to access apache hive from clickhouse. This implements: #29245. #31104 (taiyang-li).
  • Add aggregate functions cramersV, cramersVBiasCorrected, theilsU and contingency. These functions calculate dependency (measure of association) between categorical values. All these functions are using cross-tab (histogram on pairs) for implementation. You can imagine it like a correlation coefficient but for any discrete values (not necessary numbers). #33366 (alexey-milovidov). Initial implementation by Vanyok-All-is-OK and antikvist.
  • Added table function hdfsCluster which allows processing files from HDFS in parallel from many nodes in a specified cluster, similarly to s3Cluster. #32400 (Zhichang Yu).
  • Adding support for disks backed by Azure Blob Storage, in a similar way it has been done for disks backed by AWS S3. #31505 (Jakub Kuklis).
  • Allow COMMENT in CREATE VIEW (for all VIEW kinds). #31062 (Vasily Nemkov).
  • Dynamically reinitialize listening ports and protocols when configuration changes. #30549 (Kevin Michel).
  • Added left, right, leftUTF8, rightUTF8 functions. Fix error in implementation of substringUTF8 function with negative offset (offset from the end of string). #33407 (alexey-milovidov).
  • Add new functions for H3 coordinate system: h3HexAreaKm2, h3CellAreaM2, h3CellAreaRads2. #33479 (Bharat Nallan).
  • Add MONTHNAME function. #33436 (usurai).
  • Added function arrayLast. Closes #33390. #33415 Added function arrayLastIndex. #33465 (Maksim Kita).
  • Add function decodeURLFormComponent slightly different to decodeURLComponent. Close #10298. #33451 (SuperDJY).
  • Allow to split GraphiteMergeTree rollup rules for plain/tagged metrics (optional rule_type field). #33494 (Michail Safronov).

Performance Improvement​

  • Support moving conditions to PREWHERE (setting optimize_move_to_prewhere) for tables of Merge engine if its all underlying tables supports PREWHERE. #33300 (Anton Popov).
  • More efficient handling of globs for URL storage. Now you can easily query million URLs in parallel with retries. Closes #32866. #32907 (Kseniia Sumarokova).
  • Avoid exponential backtracking in parser. This closes #20158. #33481 (alexey-milovidov).
  • Abuse of untuple function was leading to exponential complexity of query analysis (found by fuzzer). This closes #33297. #33445 (alexey-milovidov).
  • Reduce allocated memory for dictionaries with string attributes. #33466 (Maksim Kita).
  • Slight performance improvement of reinterpret function. #32587 (alexey-milovidov).
  • Non significant change. In extremely rare cases when data part is lost on every replica, after merging of some data parts, the subsequent queries may skip less amount of partitions during partition pruning. This hardly affects anything. #32220 (Azat Khuzhin).
  • Improve clickhouse-keeper writing performance by optimization the size calculation logic. #32366 (zhanglistar).
  • Optimize single part projection materialization. This closes #31669. #31885 (Amos Bird).
  • Improve query performance of system tables. #33312 (OnePiece).
  • Optimize selecting of MergeTree parts that can be moved between volumes. #33225 (OnePiece).
  • Fix sparse_hashed dict performance with sequential keys (wrong hash function). #32536 (Azat Khuzhin).

Experimental Feature​

  • Parallel reading from multiple replicas within a shard during distributed query without using sample key. To enable this, set allow_experimental_parallel_reading_from_replicas = 1 and max_parallel_replicas to any number. This closes #26748. #29279 (Nikita Mikhaylov).
  • Implemented sparse serialization. It can reduce usage of disk space and improve performance of some queries for columns, which contain a lot of default (zero) values. It can be enabled by setting ratio_for_sparse_serialization. Sparse serialization will be chosen dynamically for column, if it has ratio of number of default values to number of all values above that threshold. Serialization (default or sparse) will be fixed for every column in part, but may varies between parts. #22535 (Anton Popov).
  • Add "TABLE OVERRIDE" feature for customizing MaterializedMySQL table schemas. #32325 (Stig Bakken).
  • Add EXPLAIN TABLE OVERRIDE query. #32836 (Stig Bakken).
  • Support TABLE OVERRIDE clause for MaterializedPostgreSQL. RFC: #31480. #32749 (Kseniia Sumarokova).
  • Change ZooKeeper path for zero-copy marks for shared data. Note that "zero-copy replication" is non-production feature (in early stages of development) that you shouldn't use anyway. But in case if you have used it, let you keep in mind this change. #32061 (ianton-ru).
  • Events clause support for WINDOW VIEW watch query. #32607 (vxider).
  • Fix ACL with explicit digit hash in clickhouse-keeper: now the behavior consistent with ZooKeeper and generated digest is always accepted. #33249 (小路). #33246.
  • Fix unexpected projection removal when detaching parts. #32067 (Amos Bird).

Improvement​

  • Now date time conversion functions that generates time before 1970-01-01 00:00:00 will be saturated to zero instead of overflow. #29953 (Amos Bird). It also fixes a bug in index analysis if date truncation function would yield result before the Unix epoch.
  • Always display resource usage (total CPU usage, total RAM usage and max RAM usage per host) in client. #33271 (alexey-milovidov).
  • Improve Bool type serialization and deserialization, check the range of values. #32984 (Kruglov Pavel).
  • If an invalid setting is defined using the SET query or using the query parameters in the HTTP request, error message will contain suggestions that are similar to the invalid setting string (if any exists). #32946 (Antonio Andelic).
  • Support hints for mistyped setting names for clickhouse-client and clickhouse-local. Closes #32237. #32841 (凌涛).
  • Allow to use virtual columns in Materialized Views. Close #11210. #33482 (OnePiece).
  • Add config to disable IPv6 in clickhouse-keeper if needed. This close #33381. #33450 (Wu Xueyang).
  • Add more info to system.build_options about current git revision. #33431 (taiyang-li).
  • clickhouse-local: track memory under --max_memory_usage_in_client option. #33341 (Azat Khuzhin).
  • Allow negative intervals in function intervalLengthSum. Their length will be added as well. This closes #33323. #33335 (alexey-milovidov).
  • LineAsString can be used as output format. This closes #30919. #33331 (Sergei Trifonov).
  • Support <secure/> in cluster configuration, as an alternative form of <secure>1</secure>. Close #33270. #33330 (SuperDJY).
  • Pressing Ctrl+C twice will terminate clickhouse-benchmark immediately without waiting for in-flight queries. This closes #32586. #33303 (alexey-milovidov).
  • Support Unix timestamp with milliseconds in parseDateTimeBestEffort function. #33276 (Ben).
  • Allow to cancel query while reading data from external table in the formats: Arrow / Parquet / ORC - it failed to be cancelled it case of big files and setting input_format_allow_seeks as false. Closes #29678. #33238 (Kseniia Sumarokova).
  • If table engine supports SETTINGS clause, allow to pass the settings as key-value or via config. Add this support for MySQL. #33231 (Kseniia Sumarokova).
  • Correctly prevent Nullable primary keys if necessary. This is for #32780. #33218 (Amos Bird).
  • Add retry for PostgreSQL connections in case nothing has been fetched yet. Closes #33199. #33209 (Kseniia Sumarokova).
  • Validate config keys for external dictionaries. #33095. #33130 (Kseniia Sumarokova).
  • Send profile info inside clickhouse-local. Closes #33093. #33097 (Kseniia Sumarokova).
  • Short circuit evaluation: support for function throwIf. Closes #32969. #32973 (Maksim Kita).
  • (This only happens in unofficial builds). Fixed segfault when inserting data into compressed Decimal, String, FixedString and Array columns. This closes #32939. #32940 (N. Kolotov).
  • Added support for specifying subquery as SQL user defined function. Example: CREATE FUNCTION test AS () -> (SELECT 1). Closes #30755. #32758 (Maksim Kita).
  • Improve gRPC compression support for #28671. #32747 (Vitaly Baranov).
  • Flush all In-Memory data parts when WAL is not enabled while shutdown server or detaching table. #32742 (nauta).
  • Allow to control connection timeouts for MySQL (previously was supported only for dictionary source). Closes #16669. Previously default connect_timeout was rather small, now it is configurable. #32734 (Kseniia Sumarokova).
  • Support authSource option for storage MongoDB. Closes #32594. #32702 (Kseniia Sumarokova).
  • Support Date32 type in genarateRandom table function. #32643 (nauta).
  • Add settings max_concurrent_select_queries and max_concurrent_insert_queries for control concurrent queries by query kind. Close #3575. #32609 (SuperDJY).
  • Improve handling nested structures with missing columns while reading data in Protobuf format. Follow-up to https://github.com/ClickHouse/ClickHouse/pull/31988. #32531 (Vitaly Baranov).
  • Allow empty credentials for MongoDB engine. Closes #26267. #32460 (Kseniia Sumarokova).
  • Disable some optimizations for window functions that may lead to exceptions. Closes #31535. Closes #31620. #32453 (Kseniia Sumarokova).
  • Allows to connect to MongoDB 5.0. Closes #31483,. #32416 (Kseniia Sumarokova).
  • Enable comparison between Decimal and Float. Closes #22626. #31966 (flynn).
  • Added settings command_read_timeout, command_write_timeout for StorageExecutable, StorageExecutablePool, ExecutableDictionary, ExecutablePoolDictionary, ExecutableUserDefinedFunctions. Setting command_read_timeout controls timeout for reading data from command stdout in milliseconds. Setting command_write_timeout timeout for writing data to command stdin in milliseconds. Added settings command_termination_timeout for ExecutableUserDefinedFunction, ExecutableDictionary, StorageExecutable. Added setting execute_direct for ExecutableUserDefinedFunction, by default true. Added setting execute_direct for ExecutableDictionary, ExecutablePoolDictionary, by default false. #30957 (Maksim Kita).
  • Bitmap aggregate functions will give correct result for out of range argument instead of wraparound. #33127 (DR).
  • Fix parsing incorrect queries with FROM INFILE statement. #33521 (Kruglov Pavel).
  • Don't allow to write into S3 if path contains globs. #33142 (Kruglov Pavel).
  • --echo option was not used by clickhouse-client in batch mode with single query. #32843 (N. Kolotov).
  • Use --database option for clickhouse-local. #32797 (Kseniia Sumarokova).
  • Fix surprisingly bad code in SQL ordinary function file. Now it supports symlinks. #32640 (alexey-milovidov).
  • Updating modification_time for data part in system.parts after part movement #32964. #32965 (save-my-heart).
  • Potential issue, cannot be exploited: integer overflow may happen in array resize. #33024 (varadarajkumar).

Build/Testing/Packaging Improvement​

Bug Fix (user-visible misbehavior in official stable or prestable release)​

  • Several fixes for format parsing. This is relevant if clickhouse-server is open for write access to adversary. Specifically crafted input data for Native format may lead to reading uninitialized memory or crash. This is relevant if clickhouse-server is open for write access to adversary. #33050 (Heena Bansal). Fixed Apache Avro Union type index out of boundary issue in Apache Avro binary format. #33022 (Harry Lee). Fix null pointer dereference in LowCardinality data when deserializing LowCardinality data in the Native format. #33021 (Harry Lee).
  • ClickHouse Keeper handler will correctly remove operation when response sent. #32988 (JackyWoo).
  • Potential off-by-one miscalculation of quotas: quota limit was not reached, but the limit was exceeded. This fixes #31174. #31656 (sunny).
  • Fixed CASTing from String to IPv4 or IPv6 and back. Fixed error message in case of failed conversion. #29224 (Dmitry Novik) #27914 (Vasily Nemkov).
  • Fixed an exception like Unknown aggregate function nothing during an execution on a remote server. This fixes #16689. #26074 (hexiaoting).
  • Fix wrong database for JOIN without explicit database in distributed queries (Fixes: #10471). #33611 (Azat Khuzhin).
  • Fix segfault in Apache Avro format that appears after the second insert into file. #33566 (Kruglov Pavel).
  • Fix segfault in Apache Arrow format if schema contains Dictionary type. Closes #33507. #33529 (Kruglov Pavel).
  • Out of band offset and limit settings may be applied incorrectly for views. Close #33289 #33518 (hexiaoting).
  • Fix an exception Block structure mismatch which may happen during insertion into table with default nested LowCardinality column. Fixes #33028. #33504 (Nikolai Kochetov).
  • Fix dictionary expressions for range_hashed range min and range max attributes when created using DDL. Closes #30809. #33478 (Maksim Kita).
  • Fix possible use-after-free for INSERT into Materialized View with concurrent DROP (Azat Khuzhin).
  • Do not try to read pass EOF (to workaround for a bug in the Linux kernel), this bug can be reproduced on kernels (3.14..5.9), and requires index_granularity_bytes=0 (i.e. turn off adaptive index granularity). #33372 (Azat Khuzhin).
  • The commands SYSTEM SUSPEND and SYSTEM ... THREAD FUZZER missed access control. It is fixed. Author: Kevin Michel. #33333 (alexey-milovidov).
  • Fix when COMMENT for dictionaries does not appear in system.tables, system.dictionaries. Allow to modify the comment for Dictionary engine. Closes #33251. #33261 (Maksim Kita).
  • Add asynchronous inserts (with enabled setting async_insert) to query log. Previously such queries didn't appear in the query log. #33239 (Anton Popov).
  • Fix sending WHERE 1 = 0 expressions for external databases query. Closes #33152. #33214 (Kseniia Sumarokova).
  • Fix DDL validation for MaterializedPostgreSQL. Fix setting materialized_postgresql_allow_automatic_update. Closes #29535. #33200 (Kseniia Sumarokova). Make sure unused replication slots are always removed. Found in #26952. #33187 (Kseniia Sumarokova). Fix MaterializedPostreSQL detach/attach (removing / adding to replication) tables with non-default schema. Found in #29535. #33179 (Kseniia Sumarokova). Fix DROP MaterializedPostgreSQL database. #33468 (Kseniia Sumarokova).
  • The metric StorageBufferBytes sometimes was miscalculated. #33159 (xuyatian).
  • Fix error Invalid version for SerializationLowCardinality key column in case of reading from LowCardinality column with local_filesystem_read_prefetch or remote_filesystem_read_prefetch enabled. #33046 (Nikolai Kochetov).
  • Fix s3 table function reading empty file. Closes #33008. #33037 (Kseniia Sumarokova).
  • Fix Context leak in case of cancel_http_readonly_queries_on_client_close (i.e. leaking of external tables that had been uploaded the the server and other resources). #32982 (Azat Khuzhin).
  • Fix wrong tuple output in CSV format in case of custom csv delimiter. #32981 (Kruglov Pavel).
  • Fix HDFS URL check that didn't allow using HA namenode address. Bug was introduced in https://github.com/ClickHouse/ClickHouse/pull/31042. #32976 (Kruglov Pavel).
  • Fix throwing exception like positional argument out of bounds for non-positional arguments. Closes #31173#event-5789668239. #32961 (Kseniia Sumarokova).
  • Fix UB in case of unexpected EOF during filling a set from HTTP query (i.e. if the client interrupted in the middle, i.e. timeout 0.15s curl -Ss -F 's=@t.csv;' 'http://127.0.0.1:8123/?s_structure=key+Int&query=SELECT+dummy+IN+s' and with large enough t.csv). #32955 (Azat Khuzhin).
  • Fix a regression in replaceRegexpAll function. The function worked incorrectly when matched substring was empty. This closes #32777. This closes #30245. #32945 (alexey-milovidov).
  • Fix ORC format stripe reading. #32929 (kreuzerkrieg).
  • topKWeightedState failed for some input types. #32487. #32914 (vdimir).
  • Fix exception Single chunk is expected from view inner query (LOGICAL_ERROR) in materialized view. Fixes #31419. #32862 (Nikolai Kochetov).
  • Fix optimization with lazy seek for async reads from remote filesystems. Closes #32803. #32835 (Kseniia Sumarokova).
  • MergeTree table engine might silently skip some mutations if there are too many running mutations or in case of high memory consumption, it's fixed. Fixes #17882. #32814 (tavplubix).
  • Avoid reusing the scalar subquery cache when processing MV blocks. This fixes a bug when the scalar query reference the source table but it means that all subscalar queries in the MV definition will be calculated for each block. #32811 (Raúl Marín).
  • Server might fail to start if database with MySQL engine cannot connect to MySQL server, it's fixed. Fixes #14441. #32802 (tavplubix).
  • Fix crash when used fuzzBits function, close #32737. #32755 (SuperDJY).
  • Fix error Column is not under aggregate function in case of MV with GROUP BY (list of columns) (which is pared as GROUP BY tuple(...)) over Kafka/RabbitMQ. Fixes #32668 and #32744. #32751 (Nikolai Kochetov).
  • Fix ALTER TABLE ... MATERIALIZE TTL query with TTL ... DELETE WHERE ... and TTL ... GROUP BY ... modes. #32695 (Anton Popov).
  • Fix optimize_read_in_order optimization in case when table engine is Distributed or Merge and its underlying MergeTree tables have monotonous function in prefix of sorting key. #32670 (Anton Popov).
  • Fix LOGICAL_ERROR exception when the target of a materialized view is a JOIN or a SET table. #32669 (Raúl Marín).
  • Inserting into S3 with multipart upload to Google Cloud Storage may trigger abort. #32504. #32649 (vdimir).
  • Fix possible exception at RabbitMQ storage startup by delaying channel creation. #32584 (Kseniia Sumarokova).
  • Fix table lifetime (i.e. possible use-after-free) in case of parallel DROP TABLE and INSERT. #32572 (Azat Khuzhin).
  • Fix async inserts with formats CustomSeparated, Template, Regexp, MsgPack and JSONAsString. Previousely the async inserts with these formats didn't read any data. #32530 (Kruglov Pavel).
  • Fix groupBitmapAnd function on distributed table. #32529 (minhthucdao).
  • Fix crash in JOIN found by fuzzer, close #32458. #32508 (vdimir).
  • Proper handling of the case with Apache Arrow column duplication. #32507 (Dmitriy Mokhnatkin).
  • Fix issue with ambiguous query formatting in distributed queries that led to errors when some table columns were named ALL or DISTINCT. This closes #32391. #32490 (alexey-milovidov).
  • Fix failures in queries that are trying to use skipping indices, which are not materialized yet. Fixes #32292 and #30343. #32359 (Anton Popov).
  • Fix broken select query when there are more than 2 row policies on same column, begin at second queries on the same session. #31606. #32291 (SuperDJY).
  • Fix fractional unix timestamp conversion to DateTime64, fractional part was reversed for negative unix timestamps (before 1970-01-01). #32240 (Ben).
  • Some entries of replication queue might hang for temporary_directories_lifetime (1 day by default) with Directory tmp_merge_<part_name> or Part ... (state Deleting) already exists, but it will be deleted soon or similar error. It's fixed. Fixes #29616. #32201 (tavplubix).
  • Fix parsing of APPLY lambda column transformer which could lead to client/server crash. #32138 (Kruglov Pavel).
  • Fix base64Encode adding trailing bytes on small strings. #31797 (Kevin Michel).
  • Fix possible crash (or incorrect result) in case of LowCardinality arguments of window function. Fixes #31114. #31888 (Nikolai Kochetov).
  • Fix hang up with command DROP TABLE system.query_log sync. #33293 (zhanghuajie).

Changelog for 2021​

  • ClickHouse release 22.12, 2022-12-15
  • ClickHouse release 22.11, 2022-11-17
  • ClickHouse release 22.10, 2022-10-25
  • ClickHouse release 22.9, 2022-09-22
  • ClickHouse release 22.8, 2022-08-18
  • ClickHouse release 22.7, 2022-07-21
  • ClickHouse release 22.6, 2022-06-16
  • ClickHouse release 22.5, 2022-05-19
  • ClickHouse release 22.4, 2022-04-19
  • ClickHouse release v22.3-lts, 2022-03-17
  • ClickHouse release v22.2, 2022-02-17
  • ClickHouse release v22.1, 2022-01-18
  • Changelog for 2021