Merge branch 'master' of https://github.com/ClickHouse/ClickHouse into merge

README.md

@@ -8,7 +8,7 @@ ClickHouse® is an open-source column-oriented database management system that a
 * [Tutorial](https://clickhouse.tech/docs/en/getting_started/tutorial/) shows how to set up and query small ClickHouse cluster.
 * [Documentation](https://clickhouse.tech/docs/en/) provides more in-depth information.
 * [YouTube channel](https://www.youtube.com/c/ClickHouseDB) has a lot of content about ClickHouse in video format.
-* [Slack](https://join.slack.com/t/clickhousedb/shared_invite/zt-qfort0u8-TWqK4wIP0YSdoDE0btKa1w) and [Telegram](https://telegram.me/clickhouse_en) allow to chat with ClickHouse users in real-time.
+* [Slack](https://join.slack.com/t/clickhousedb/shared_invite/zt-rxm3rdrk-lIUmhLC3V8WTaL0TGxsOmg) and [Telegram](https://telegram.me/clickhouse_en) allow to chat with ClickHouse users in real-time.
 * [Blog](https://clickhouse.yandex/blog/en/) contains various ClickHouse-related articles, as well as announcements and reports about events.
 * [Code Browser](https://clickhouse.tech/codebrowser/html_report/ClickHouse/index.html) with syntax highlight and navigation.
 * [Contacts](https://clickhouse.tech/#contacts) can help to get your questions answered if there are any.

base/common/ReplxxLineReader.cpp

@@ -1,8 +1,9 @@
 #include <common/ReplxxLineReader.h>
 #include <common/errnoToString.h>
 
-#include <errno.h>
-#include <string.h>
+#include <chrono>
+#include <cerrno>
+#include <cstring>
 #include <unistd.h>
 #include <functional>
 #include <sys/file.h>
@@ -24,6 +25,94 @@ void trim(String & s)
     s.erase(std::find_if(s.rbegin(), s.rend(), [](int ch) { return !std::isspace(ch); }).base(), s.end());
 }
 
+/// Copied from replxx::src/util.cxx::now_ms_str() under the terms of 3-clause BSD license of Replxx.
+/// Copyright (c) 2017-2018, Marcin Konarski (amok at codestation.org)
+/// Copyright (c) 2010, Salvatore Sanfilippo (antirez at gmail dot com)
+/// Copyright (c) 2010, Pieter Noordhuis (pcnoordhuis at gmail dot com)
+static std::string replxx_now_ms_str()
+{
+    std::chrono::milliseconds ms(std::chrono::duration_cast<std::chrono::milliseconds>(std::chrono::system_clock::now().time_since_epoch()));
+    time_t t = ms.count() / 1000;
+    tm broken;
+    if (!localtime_r(&t, &broken))
+    {
+        return std::string();
+    }
+
+    static int const BUFF_SIZE(32);
+    char str[BUFF_SIZE];
+    strftime(str, BUFF_SIZE, "%Y-%m-%d %H:%M:%S.", &broken);
+    snprintf(str + sizeof("YYYY-mm-dd HH:MM:SS"), 5, "%03d", static_cast<int>(ms.count() % 1000));
+    return str;
+}
+
+/// Convert from readline to replxx format.
+///
+/// replxx requires each history line to prepended with time line:
+///
+///     ### YYYY-MM-DD HH:MM:SS.SSS
+///     select 1
+///
+/// And w/o those service lines it will load all lines from history file as
+/// one history line for suggestion. And if there are lots of lines in file it
+/// will take lots of time (getline() + tons of reallocations).
+///
+/// NOTE: this code uses std::ifstream/std::ofstream like original replxx code.
+void convertHistoryFile(const std::string & path, replxx::Replxx & rx)
+{
+    std::ifstream in(path);
+    if (!in)
+    {
+        rx.print("Cannot open %s reading (for conversion): %s\n",
+            path.c_str(), errnoToString(errno).c_str());
+        return;
+    }
+
+    std::string line;
+    if (!getline(in, line).good())
+    {
+        rx.print("Cannot read from %s (for conversion): %s\n",
+            path.c_str(), errnoToString(errno).c_str());
+        return;
+    }
+
+    /// This is the marker of the date, no need to convert.
+    static char const REPLXX_TIMESTAMP_PATTERN[] = "### dddd-dd-dd dd:dd:dd.ddd";
+    if (line.starts_with("### ") && line.size() == strlen(REPLXX_TIMESTAMP_PATTERN))
+    {
+        return;
+    }
+
+    std::vector<std::string> lines;
+    in.seekg(0);
+    while (getline(in, line).good())
+    {
+        lines.push_back(line);
+    }
+    in.close();
+
+    size_t lines_size = lines.size();
+    std::sort(lines.begin(), lines.end());
+    lines.erase(std::unique(lines.begin(), lines.end()), lines.end());
+    rx.print("The history file (%s) is in old format. %zu lines, %zu unique lines.\n",
+        path.c_str(), lines_size, lines.size());
+
+    std::ofstream out(path);
+    if (!out)
+    {
+        rx.print("Cannot open %s for writing (for conversion): %s\n",
+            path.c_str(), errnoToString(errno).c_str());
+        return;
+    }
+
+    const std::string & timestamp = replxx_now_ms_str();
+    for (const auto & out_line : lines)
+    {
+        out << "### " << timestamp << "\n" << out_line << std::endl;
+    }
+    out.close();
+}
+
 }
 
 ReplxxLineReader::ReplxxLineReader(
@@ -47,6 +136,8 @@ ReplxxLineReader::ReplxxLineReader(
         }
         else
         {
+            convertHistoryFile(history_file_path, rx);
+
             if (flock(history_file_fd, LOCK_SH))
             {
                 rx.print("Shared lock of history file failed: %s\n", errnoToString(errno).c_str());

docker/test/performance-comparison/compare.sh

@@ -319,14 +319,14 @@ function get_profiles
 
     wait
 
-    clickhouse-client --port $LEFT_SERVER_PORT --query "select * from system.query_log where type = 2 format TSVWithNamesAndTypes" > left-query-log.tsv ||: &
+    clickhouse-client --port $LEFT_SERVER_PORT --query "select * from system.query_log where type = 'QueryFinish' format TSVWithNamesAndTypes" > left-query-log.tsv ||: &
     clickhouse-client --port $LEFT_SERVER_PORT --query "select * from system.query_thread_log format TSVWithNamesAndTypes" > left-query-thread-log.tsv ||: &
     clickhouse-client --port $LEFT_SERVER_PORT --query "select * from system.trace_log format TSVWithNamesAndTypes" > left-trace-log.tsv ||: &
     clickhouse-client --port $LEFT_SERVER_PORT --query "select arrayJoin(trace) addr, concat(splitByChar('/', addressToLine(addr))[-1], '#', demangle(addressToSymbol(addr)) ) name from system.trace_log group by addr format TSVWithNamesAndTypes" > left-addresses.tsv ||: &
     clickhouse-client --port $LEFT_SERVER_PORT --query "select * from system.metric_log format TSVWithNamesAndTypes" > left-metric-log.tsv ||: &
     clickhouse-client --port $LEFT_SERVER_PORT --query "select * from system.asynchronous_metric_log format TSVWithNamesAndTypes" > left-async-metric-log.tsv ||: &
 
-    clickhouse-client --port $RIGHT_SERVER_PORT --query "select * from system.query_log where type = 2 format TSVWithNamesAndTypes" > right-query-log.tsv ||: &
+    clickhouse-client --port $RIGHT_SERVER_PORT --query "select * from system.query_log where type = 'QueryFinish' format TSVWithNamesAndTypes" > right-query-log.tsv ||: &
     clickhouse-client --port $RIGHT_SERVER_PORT --query "select * from system.query_thread_log format TSVWithNamesAndTypes" > right-query-thread-log.tsv ||: &
     clickhouse-client --port $RIGHT_SERVER_PORT --query "select * from system.trace_log format TSVWithNamesAndTypes" > right-trace-log.tsv ||: &
     clickhouse-client --port $RIGHT_SERVER_PORT --query "select arrayJoin(trace) addr, concat(splitByChar('/', addressToLine(addr))[-1], '#', demangle(addressToSymbol(addr)) ) name from system.trace_log group by addr format TSVWithNamesAndTypes" > right-addresses.tsv ||: &
@@ -409,10 +409,10 @@ create view right_query_log as select *
         '$(cat "right-query-log.tsv.columns")');
 
 create view query_logs as
-    select 0 version, query_id, ProfileEvents.keys, ProfileEvents.values,
+    select 0 version, query_id, ProfileEvents,
         query_duration_ms, memory_usage from left_query_log
     union all
-    select 1 version, query_id, ProfileEvents.keys, ProfileEvents.values,
+    select 1 version, query_id, ProfileEvents,
         query_duration_ms, memory_usage from right_query_log
     ;
 
@@ -424,7 +424,7 @@ create table query_run_metric_arrays engine File(TSV, 'analyze/query-run-metric-
     with (
         -- sumMapState with the list of all keys with '-0.' values. Negative zero is because
         -- sumMap removes keys with positive zeros.
-        with (select groupUniqArrayArray(ProfileEvents.keys) from query_logs) as all_names
+        with (select groupUniqArrayArray(mapKeys(ProfileEvents)) from query_logs) as all_names
             select arrayReduce('sumMapState', [(all_names, arrayMap(x->-0., all_names))])
         ) as all_metrics
     select test, query_index, version, query_id,
@@ -433,8 +433,8 @@ create table query_run_metric_arrays engine File(TSV, 'analyze/query-run-metric-
                 [
                     all_metrics,
                     arrayReduce('sumMapState',
-                        [(ProfileEvents.keys,
-                            arrayMap(x->toFloat64(x), ProfileEvents.values))]
+                        [(mapKeys(ProfileEvents),
+                            arrayMap(x->toFloat64(x), mapValues(ProfileEvents)))]
                     ),
                     arrayReduce('sumMapState', [(
                         ['client_time', 'server_time', 'memory_usage'],
@@ -1003,10 +1003,11 @@ create view query_log as select *
 
 create table unstable_run_metrics engine File(TSVWithNamesAndTypes,
         'unstable-run-metrics.$version.rep') as
-    select
-        test, query_index, query_id,
-        ProfileEvents.values value, ProfileEvents.keys metric
-    from query_log array join ProfileEvents
+    select test, query_index, query_id, value, metric
+    from query_log
+    array join
+        mapValues(ProfileEvents) as value,
+        mapKeys(ProfileEvents) as metric
     join unstable_query_runs using (query_id)
     ;
 

docs/en/introduction/adopters.md

@@ -155,5 +155,6 @@ toc_title: Adopters
 | <a href="https://www.argedor.com/en/clickhouse/" class="favicon">Argedor</a> | ClickHouse support | — | — | — | [Official website](https://www.argedor.com/en/clickhouse/) |
 | <a href="https://signoz.io/" class="favicon">SigNoz</a> | Observability Platform | Main Product | — | — | [Source code](https://github.com/SigNoz/signoz) |
 | <a href="https://chelpipegroup.com/" class="favicon">ChelPipe Group</a> | Analytics | — | — | — | [Blog post, June 2021](https://vc.ru/trade/253172-tyazhelomu-proizvodstvu-user-friendly-sayt-internet-magazin-trub-dlya-chtpz) |
+| <a href="https://zagravagames.com/en/" class="favicon">Zagrava Trading</a> | — | — | — | — | [Job offer, May 2021](https://twitter.com/datastackjobs/status/1394707267082063874) |
 
 [Original article](https://clickhouse.tech/docs/en/introduction/adopters/) <!--hide-->

docs/en/operations/system-tables/asynchronous_metric_log.md

@@ -36,4 +36,4 @@ SELECT * FROM system.asynchronous_metric_log LIMIT 10
 - [system.asynchronous_metrics](../system-tables/asynchronous_metrics.md) — Contains metrics, calculated periodically in the background. 
 - [system.metric_log](../system-tables/metric_log.md) — Contains history of metrics values from tables `system.metrics` and `system.events`, periodically flushed to disk.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/asynchronous_metric_log) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/asynchronous_metric_log) <!--hide-->

docs/en/operations/system-tables/asynchronous_metrics.md

@@ -33,6 +33,6 @@ SELECT * FROM system.asynchronous_metrics LIMIT 10
 -   [Monitoring](../../operations/monitoring.md) — Base concepts of ClickHouse monitoring.
 -   [system.metrics](../../operations/system-tables/metrics.md#system_tables-metrics) — Contains instantly calculated metrics.
 -   [system.events](../../operations/system-tables/events.md#system_tables-events) — Contains a number of events that have occurred.
--   [system.metric_log](../../operations/system-tables/metric_log.md#system_tables-metric_log) — Contains a history of metrics values from tables `system.metrics` и `system.events`.
+-   [system.metric_log](../../operations/system-tables/metric_log.md#system_tables-metric_log) — Contains a history of metrics values from tables `system.metrics` and `system.events`.
 
- [Original article](https://clickhouse.tech/docs/en/operations/system_tables/asynchronous_metrics) <!--hide-->
+ [Original article](https://clickhouse.tech/docs/en/operations/system-tables/asynchronous_metrics) <!--hide-->

docs/en/operations/system-tables/clusters.md

@@ -68,4 +68,4 @@ estimated_recovery_time: 0
 -   [distributed_replica_error_cap setting](../../operations/settings/settings.md#settings-distributed_replica_error_cap)
 -   [distributed_replica_error_half_life setting](../../operations/settings/settings.md#settings-distributed_replica_error_half_life)
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/clusters) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/clusters) <!--hide-->

docs/en/operations/system-tables/columns.md

@@ -69,4 +69,21 @@ is_in_sampling_key:      0
 compression_codec:       
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/columns) <!--hide-->
+The `system.columns` table contains the following columns (the column type is shown in brackets):
+
+-   `database` (String) — Database name.
+-   `table` (String) — Table name.
+-   `name` (String) — Column name.
+-   `type` (String) — Column type.
+-   `default_kind` (String) — Expression type (`DEFAULT`, `MATERIALIZED`, `ALIAS`) for the default value, or an empty string if it is not defined.
+-   `default_expression` (String) — Expression for the default value, or an empty string if it is not defined.
+-   `data_compressed_bytes` (UInt64) — The size of compressed data, in bytes.
+-   `data_uncompressed_bytes` (UInt64) — The size of decompressed data, in bytes.
+-   `marks_bytes` (UInt64) — The size of marks, in bytes.
+-   `comment` (String) — Comment on the column, or an empty string if it is not defined.
+-   `is_in_partition_key` (UInt8) — Flag that indicates whether the column is in the partition expression.
+-   `is_in_sorting_key` (UInt8) — Flag that indicates whether the column is in the sorting key expression.
+-   `is_in_primary_key` (UInt8) — Flag that indicates whether the column is in the primary key expression.
+-   `is_in_sampling_key` (UInt8) — Flag that indicates whether the column is in the sampling key expression.
+
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/columns) <!--hide-->

docs/en/operations/system-tables/contributors.md

@@ -38,4 +38,4 @@ SELECT * FROM system.contributors WHERE name = 'Olga Khvostikova'
 │ Olga Khvostikova │
 └──────────────────┘
 ```
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/contributors) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/contributors) <!--hide-->

docs/en/operations/system-tables/current-roles.md

@@ -8,4 +8,4 @@ Columns:
  - `with_admin_option` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Flag that shows whether `current_role` is a role with `ADMIN OPTION` privilege.
  - `is_default` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Flag that shows whether `current_role` is a default role.
 
- [Original article](https://clickhouse.tech/docs/en/operations/system_tables/current-roles) <!--hide-->
+ [Original article](https://clickhouse.tech/docs/en/operations/system-tables/current-roles) <!--hide-->

docs/en/operations/system-tables/data_type_families.md

@@ -33,4 +33,4 @@ SELECT * FROM system.data_type_families WHERE alias_to = 'String'
 
 -   [Syntax](../../sql-reference/syntax.md) — Information about supported syntax.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/data_type_families) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/data_type_families) <!--hide-->

docs/en/operations/system-tables/databases.md

@@ -35,4 +35,4 @@ SELECT * FROM system.databases
 └────────────────────────────────┴────────┴────────────────────────────┴─────────────────────────────────────────────────────────────────────┴──────────────────────────────────────┘
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/databases) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/databases) <!--hide-->

docs/en/operations/system-tables/detached_parts.md

@@ -8,4 +8,4 @@ For the description of other columns, see [system.parts](../../operations/system
 
 If part name is invalid, values of some columns may be `NULL`. Such parts can be deleted with [ALTER TABLE DROP DETACHED PART](../../sql-reference/statements/alter/partition.md#alter_drop-detached).
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/detached_parts) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/detached_parts) <!--hide-->

docs/en/operations/system-tables/dictionaries.md

@@ -61,4 +61,4 @@ SELECT * FROM system.dictionaries
 └──────────┴──────┴────────┴─────────────┴──────┴────────┴──────────────────────────────────────┴─────────────────────┴─────────────────┴─────────────┴──────────┴───────────────┴───────────────────────┴────────────────────────────┴──────────────┴──────────────┴─────────────────────┴──────────────────────────────┘───────────────────────┴────────────────┘
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/dictionaries) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/dictionaries) <!--hide-->

docs/en/operations/system-tables/disks.md

@@ -10,9 +10,6 @@ Columns:
 -   `total_space` ([UInt64](../../sql-reference/data-types/int-uint.md)) — Disk volume in bytes.
 -   `keep_free_space` ([UInt64](../../sql-reference/data-types/int-uint.md)) — Amount of disk space that should stay free on disk in bytes. Defined in the `keep_free_space_bytes` parameter of disk configuration.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/disks) <!--hide-->
-
-
 **Example**
 
 ```sql
@@ -27,5 +24,4 @@ Columns:
 1 rows in set. Elapsed: 0.001 sec. 
 ```
 
-
-
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/disks) <!--hide-->

docs/en/operations/system-tables/enabled-roles.md

@@ -9,4 +9,4 @@ Columns:
 - `is_current` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Flag that shows whether `enabled_role` is a current role of a current user.
 - `is_default` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Flag that shows whether `enabled_role` is a default role.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/enabled-roles) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/enabled-roles) <!--hide-->

docs/en/operations/system-tables/events.md

@@ -31,4 +31,4 @@ SELECT * FROM system.events LIMIT 5
 -   [system.metric_log](../../operations/system-tables/metric_log.md#system_tables-metric_log) — Contains a history of metrics values from tables `system.metrics` и `system.events`.
 -   [Monitoring](../../operations/monitoring.md) — Base concepts of ClickHouse monitoring.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/events) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/events) <!--hide-->

docs/en/operations/system-tables/functions.md

@@ -7,8 +7,6 @@ Columns:
 -   `name`(`String`) – The name of the function.
 -   `is_aggregate`(`UInt8`) — Whether the function is aggregate.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/functions) <!--hide-->
-
 **Example**
 
 ```sql
@@ -30,4 +28,6 @@ Columns:
 └──────────────────────────┴──────────────┴──────────────────┴──────────┘
 
 10 rows in set. Elapsed: 0.002 sec. 
-```
+```
+
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/functions) <!--hide-->

docs/en/operations/system-tables/grants.md

@@ -21,4 +21,4 @@ Columns:
 
 -    `grant_option` ([UInt8](../../sql-reference/data-types/int-uint.md#uint-ranges)) — Permission is granted `WITH GRANT OPTION`, see [GRANT](../../sql-reference/statements/grant.md#grant-privigele-syntax).
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/grants) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/grants) <!--hide-->

docs/en/operations/system-tables/graphite_retentions.md

@@ -14,4 +14,4 @@ Columns:
 -   `Tables.database` (Array(String)) - Array of names of database tables that use the `config_name` parameter.
 -   `Tables.table` (Array(String)) - Array of table names that use the `config_name` parameter.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/graphite_retentions) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/graphite_retentions) <!--hide-->

docs/en/operations/system-tables/licenses.md

@@ -36,4 +36,4 @@ SELECT library_name, license_type, license_path FROM system.licenses LIMIT 15
 
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/licenses) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/licenses) <!--hide-->

docs/en/operations/system-tables/merge_tree_settings.md

@@ -51,4 +51,4 @@ type:        SettingUInt64
 4 rows in set. Elapsed: 0.001 sec. 
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/merge_tree_settings) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/merge_tree_settings) <!--hide-->

docs/en/operations/system-tables/merges.md

@@ -22,4 +22,4 @@ Columns:
 -   `merge_type` — The type of current merge. Empty if it's an mutation.
 -   `merge_algorithm` — The algorithm used in current merge. Empty if it's an mutation.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/merges) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/merges) <!--hide-->

docs/en/operations/system-tables/metric_log.md

@@ -48,4 +48,4 @@ CurrentMetric_DistributedFilesToInsert:                          0
 -   [system.metrics](../../operations/system-tables/metrics.md) — Contains instantly calculated metrics.
 -   [Monitoring](../../operations/monitoring.md) — Base concepts of ClickHouse monitoring.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/metric_log) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/metric_log) <!--hide-->

docs/en/operations/system-tables/metrics.md

@@ -38,4 +38,4 @@ SELECT * FROM system.metrics LIMIT 10
 -   [system.metric_log](../../operations/system-tables/metric_log.md#system_tables-metric_log) — Contains a history of metrics values from tables `system.metrics` и `system.events`.
 -   [Monitoring](../../operations/monitoring.md) — Base concepts of ClickHouse monitoring.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/metrics) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/metrics) <!--hide-->

docs/en/operations/system-tables/mutations.md

@@ -45,4 +45,4 @@ If there were problems with mutating some data parts, the following columns cont
 -   [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md) table engine
 -   [ReplicatedMergeTree](../../engines/table-engines/mergetree-family/replication.md) family
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/mutations) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/mutations) <!--hide-->

docs/en/operations/system-tables/numbers.md

@@ -29,4 +29,4 @@ Reads from this table are not parallelized.
 10 rows in set. Elapsed: 0.001 sec. 
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/numbers) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/numbers) <!--hide-->

docs/en/operations/system-tables/numbers_mt.md

@@ -27,4 +27,4 @@ Used for tests.
 10 rows in set. Elapsed: 0.001 sec. 
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/numbers_mt) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/numbers_mt) <!--hide-->

docs/en/operations/system-tables/one.md

@@ -20,4 +20,4 @@ This is similar to the `DUAL` table found in other DBMSs.
 1 rows in set. Elapsed: 0.001 sec. 
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/one) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/one) <!--hide-->

docs/en/operations/system-tables/part_log.md

@@ -66,4 +66,4 @@ error:                         0
 exception:                   
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/part_log) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/part_log) <!--hide-->

docs/en/operations/system-tables/parts.md

@@ -155,4 +155,4 @@ move_ttl_info.max:                     []
 -   [MergeTree family](../../engines/table-engines/mergetree-family/mergetree.md)
 -   [TTL for Columns and Tables](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-ttl)
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/parts) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/parts) <!--hide-->

docs/en/operations/system-tables/processes.md

@@ -14,7 +14,6 @@ Columns:
 -   `query` (String) – The query text. For `INSERT`, it does not include the data to insert.
 -   `query_id` (String) – Query ID, if defined.
 
-
 ```sql
 :) SELECT * FROM system.processes LIMIT 10 FORMAT Vertical;
 ```
@@ -59,4 +58,4 @@ Settings:             {'background_pool_size':'32','load_balancing':'random','al
 1 rows in set. Elapsed: 0.002 sec.
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/processes) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/processes) <!--hide-->

docs/en/operations/system-tables/query_log.md

@@ -156,4 +156,4 @@ Settings:             {'background_pool_size':'32','load_balancing':'random','al
 
 -   [system.query_thread_log](../../operations/system-tables/query_thread_log.md#system_tables-query_thread_log) — This table contains information about each query execution thread.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/query_log) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/query_log) <!--hide-->

docs/en/operations/system-tables/query_thread_log.md

@@ -113,4 +113,4 @@ ProfileEvents:        {'Query':1,'SelectQuery':1,'ReadCompressedBytes':36,'Compr
 
 -   [system.query_log](../../operations/system-tables/query_log.md#system_tables-query_log) — Description of the `query_log` system table which contains common information about queries execution.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/query_thread_log) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/query_thread_log) <!--hide-->

docs/en/operations/system-tables/quota_limits.md

@@ -17,3 +17,5 @@ Columns:
 - `max_read_rows` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — Maximum number of rows read from all tables and table functions participated in queries.
 - `max_read_bytes` ([Nullable](../../sql-reference/data-types/nullable.md)([UInt64](../../sql-reference/data-types/int-uint.md))) — Maximum number of bytes read from all tables and table functions participated in queries.
 - `max_execution_time` ([Nullable](../../sql-reference/data-types/nullable.md)([Float64](../../sql-reference/data-types/float.md))) — Maximum of the query execution time, in seconds.
+
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/quota_limits) <!--hide-->

docs/en/operations/system-tables/quota_usage.md

@@ -28,3 +28,5 @@ Columns:
 ## See Also {#see-also}
 
 -   [SHOW QUOTA](../../sql-reference/statements/show.md#show-quota-statement)
+
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/quota_usage) <!--hide-->

docs/en/operations/system-tables/quotas.md

@@ -24,5 +24,5 @@ Columns:
 
 -   [SHOW QUOTAS](../../sql-reference/statements/show.md#show-quotas-statement)
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/quotas) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/quotas) <!--hide-->
 

docs/en/operations/system-tables/quotas_usage.md

@@ -30,4 +30,6 @@ Columns:
 
 ## See Also {#see-also}
 
--   [SHOW QUOTA](../../sql-reference/statements/show.md#show-quota-statement)
+-   [SHOW QUOTA](../../sql-reference/statements/show.md#show-quota-statement)
+
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/quotas_usage) <!--hide-->

docs/en/operations/system-tables/replicas.md

@@ -120,5 +120,5 @@ WHERE
 
 If this query does not return anything, it means that everything is fine.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/replicas) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/replicas) <!--hide-->
 

docs/en/operations/system-tables/role-grants.md

@@ -18,4 +18,4 @@ Columns:
     -   1 — The role has `ADMIN OPTION` privilege.
     -   0 — The role without `ADMIN OPTION` privilege. 
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/role-grants) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/role-grants) <!--hide-->

docs/en/operations/system-tables/roles.md

@@ -12,4 +12,4 @@ Columns:
 
 -   [SHOW ROLES](../../sql-reference/statements/show.md#show-roles-statement)
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/roles) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/roles) <!--hide-->

docs/en/operations/system-tables/row_policies.md

@@ -31,4 +31,4 @@ Columns:
 
 -   [SHOW POLICIES](../../sql-reference/statements/show.md#show-policies-statement)
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/row_policies) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/row_policies) <!--hide-->

docs/en/operations/system-tables/settings.md

@@ -50,4 +50,4 @@ SELECT * FROM system.settings WHERE changed AND name='load_balancing'
 -   [Constraints on Settings](../../operations/settings/constraints-on-settings.md)
 -   [SHOW SETTINGS](../../sql-reference/statements/show.md#show-settings) statement
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/settings) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/settings) <!--hide-->

docs/en/operations/system-tables/settings_profile_elements.md

@@ -27,4 +27,4 @@ Columns:
 
 -    `inherit_profile` ([Nullable](../../sql-reference/data-types/nullable.md)([String](../../sql-reference/data-types/string.md))) — A parent profile for this setting profile. `NULL` if not set. Setting profile will inherit all the settings' values and constraints (`min`, `max`, `readonly`) from its parent profiles.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/settings_profile_elements) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/settings_profile_elements) <!--hide-->

docs/en/operations/system-tables/settings_profiles.md

@@ -21,4 +21,4 @@ Columns:
 
 -   [SHOW PROFILES](../../sql-reference/statements/show.md#show-profiles-statement)
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/settings_profiles) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/settings_profiles) <!--hide-->

docs/en/operations/system-tables/storage_policies.md

@@ -14,4 +14,4 @@ Columns:
 
 If the storage policy contains more then one volume, then information for each volume is stored in the individual row of the table.
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/storage_policies) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/storage_policies) <!--hide-->

docs/en/operations/system-tables/table_engines.md

@@ -35,4 +35,4 @@ WHERE name in ('Kafka', 'MergeTree', 'ReplicatedCollapsingMergeTree')
 -   Kafka [settings](../../engines/table-engines/integrations/kafka.md#table_engine-kafka-creating-a-table)
 -   Join [settings](../../engines/table-engines/special/join.md#join-limitations-and-settings)
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/table_engines) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/table_engines) <!--hide-->

docs/en/operations/system-tables/tables.md

@@ -117,4 +117,4 @@ lifetime_bytes:             ᴺᵁᴸᴸ
 comment:
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/tables) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/tables) <!--hide-->

docs/en/operations/system-tables/text_log.md

@@ -50,4 +50,4 @@ source_file:             /ClickHouse/src/Interpreters/DNSCacheUpdater.cpp; void
 source_line:             45
 ```
  
- [Original article](https://clickhouse.tech/docs/en/operations/system_tables/text_log) <!--hide-->
+ [Original article](https://clickhouse.tech/docs/en/operations/system-tables/text_log) <!--hide-->

docs/en/operations/system-tables/time_zones.md

@@ -27,4 +27,4 @@ SELECT * FROM system.time_zones LIMIT 10
 └────────────────────┘
 ```
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/time_zones) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/time_zones) <!--hide-->

docs/en/operations/system-tables/trace_log.md

@@ -55,4 +55,3 @@ size:                    5244400
 ```
 
  [Original article](https://clickhouse.tech/docs/en/operations/system-tables/trace_log) <!--hide-->
- 

docs/en/operations/system-tables/users.md

@@ -31,4 +31,4 @@ Columns:
 
 -   [SHOW USERS](../../sql-reference/statements/show.md#show-users-statement)
 
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/users) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/users) <!--hide-->

docs/en/operations/system-tables/zookeeper.md

@@ -72,4 +72,4 @@ numChildren:    7
 pzxid:          987021252247
 path:           /clickhouse/tables/01-08/visits/replicas
 ```
-[Original article](https://clickhouse.tech/docs/en/operations/system_tables/zookeeper) <!--hide-->
+[Original article](https://clickhouse.tech/docs/en/operations/system-tables/zookeeper) <!--hide-->

docs/en/sql-reference/functions/tuple-map-functions.md

@@ -70,23 +70,23 @@ Result:
 
 Collect all the keys and sum corresponding values.
 
-**Syntax** 
+**Syntax**
 
 ``` sql
-mapAdd(Tuple(Array, Array), Tuple(Array, Array) [, ...])
+mapAdd(arg1, arg2 [, ...])
 ```
 
-**Arguments** 
+**Arguments**
 
-Arguments are [tuples](../../sql-reference/data-types/tuple.md#tuplet1-t2) of two [arrays](../../sql-reference/data-types/array.md#data-type-array), where items in the first array represent keys, and the second array contains values for the each key. All key arrays should have same type, and all value arrays should contain items which are promote to the one type ([Int64](../../sql-reference/data-types/int-uint.md#int-ranges), [UInt64](../../sql-reference/data-types/int-uint.md#uint-ranges) or [Float64](../../sql-reference/data-types/float.md#float32-float64)). The common promoted type is used as a type for the result array.
+Arguments are [maps](../../sql-reference/data-types/map.md) or [tuples](../../sql-reference/data-types/tuple.md#tuplet1-t2) of two [arrays](../../sql-reference/data-types/array.md#data-type-array), where items in the first array represent keys, and the second array contains values for the each key. All key arrays should have same type, and all value arrays should contain items which are promote to the one type ([Int64](../../sql-reference/data-types/int-uint.md#int-ranges), [UInt64](../../sql-reference/data-types/int-uint.md#uint-ranges) or [Float64](../../sql-reference/data-types/float.md#float32-float64)). The common promoted type is used as a type for the result array.
 
 **Returned value**
 
--   Returns one [tuple](../../sql-reference/data-types/tuple.md#tuplet1-t2), where the first array contains the sorted keys and the second array contains values.
+-   Depending on the arguments returns one [map](../../sql-reference/data-types/map.md) or [tuple](../../sql-reference/data-types/tuple.md#tuplet1-t2), where the first array contains the sorted keys and the second array contains values.
 
 **Example**
 
-Query:
+Query with a tuple map:
 
 ``` sql
 SELECT mapAdd(([toUInt8(1), 2], [1, 1]), ([toUInt8(1), 2], [1, 1])) as res, toTypeName(res) as type;
@@ -100,6 +100,11 @@ Result:
 └───────────────┴────────────────────────────────────┘
 ```
 
+Query with `Map` type:
+
+``` sql
+```
+
 ## mapSubtract {#function-mapsubtract}
 
 Collect all the keys and subtract corresponding values.

docs/zh/engines/table-engines/mergetree-family/mergetree.md

@@ -6,21 +6,21 @@ Clickhouse 中最强大的表引擎当属 `MergeTree` （合并树）引擎及
 
 主要特点:
 
--   存储的数据按主键排序。
+- 存储的数据按主键排序。
 
-    这使得你能够创建一个小型的稀疏索引来加快数据检索。
+    这使得您能够创建一个小型的稀疏索引来加快数据检索。
 
--   支持数据分区，如果指定了 [分区键](custom-partitioning-key.md) 的话。
+- 如果指定了 [分区键](custom-partitioning-key.md) 的话，可以使用分区。
 
     在相同数据集和相同结果集的情况下 ClickHouse 中某些带分区的操作会比普通操作更快。查询中指定了分区键时 ClickHouse 会自动截取分区数据。这也有效增加了查询性能。
 
--   支持数据副本。
+- 支持数据副本。
 
     `ReplicatedMergeTree` 系列的表提供了数据副本功能。更多信息，请参阅 [数据副本](replication.md) 一节。
 
--   支持数据采样。
+- 支持数据采样。
 
-    需要的话，你可以给表设置一个采样方法。
+    需要的话，您可以给表设置一个采样方法。
 
 !!! note "注意"
     [合并](../special/merge.md#merge) 引擎并不属于 `*MergeTree` 系列。
@@ -50,54 +50,58 @@ ORDER BY expr
 
 **子句**
 
--   `ENGINE` - 引擎名和参数。 `ENGINE = MergeTree()`. `MergeTree` 引擎没有参数。
+- `ENGINE` - 引擎名和参数。 `ENGINE = MergeTree()`. `MergeTree` 引擎没有参数。
 
-
--   `ORDER BY` — 排序键。
+- `ORDER BY` — 排序键。
 
      可以是一组列的元组或任意的表达式。 例如: `ORDER BY (CounterID, EventDate)` 。
-     
-     如果没有使用 `PRIMARY KEY` 显式的指定主键，ClickHouse 会使用排序键作为主键。
-     
+
+     如果没有使用 `PRIMARY KEY` 显式指定的主键，ClickHouse 会使用排序键作为主键。
+
      如果不需要排序，可以使用 `ORDER BY tuple()`. 参考 [选择主键](https://clickhouse.tech/docs/en/engines/table-engines/mergetree-family/mergetree/#selecting-the-primary-key)
 
--   `PARTITION BY` — [分区键](custom-partitioning-key.md) 。
+- `PARTITION BY` — [分区键](custom-partitioning-key.md) ，可选项。
 
      要按月分区，可以使用表达式 `toYYYYMM(date_column)` ，这里的 `date_column` 是一个 [Date](../../../engines/table-engines/mergetree-family/mergetree.md) 类型的列。分区名的格式会是 `"YYYYMM"` 。
 
--   `PRIMARY KEY` - 主键，如果要 [选择与排序键不同的主键](#choosing-a-primary-key-that-differs-from-the-sorting-key)，可选。
+- `PRIMARY KEY` - 如果要 [选择与排序键不同的主键](#choosing-a-primary-key-that-differs-from-the-sorting-key)，在这里指定，可选项。
 
     默认情况下主键跟排序键（由 `ORDER BY` 子句指定）相同。
     因此，大部分情况下不需要再专门指定一个 `PRIMARY KEY` 子句。
 
--   `SAMPLE BY` — 用于抽样的表达式。
+- `SAMPLE BY` - 用于抽样的表达式，可选项。
 
      如果要用抽样表达式，主键中必须包含这个表达式。例如：
      `SAMPLE BY intHash32(UserID) ORDER BY (CounterID, EventDate, intHash32(UserID))` 。
-     
--   TTL 指定行存储的持续时间并定义数据片段在硬盘和卷上的移动逻辑的规则列表，可选。
+
+- `TTL` - 指定行存储的持续时间并定义数据片段在硬盘和卷上的移动逻辑的规则列表，可选项。
 
     表达式中必须存在至少一个 `Date` 或 `DateTime` 类型的列，比如：
-    
+
     `TTL date + INTERVAl 1 DAY`
-    
+
     规则的类型 `DELETE|TO DISK 'xxx'|TO VOLUME 'xxx'`指定了当满足条件（到达指定时间）时所要执行的动作：移除过期的行，还是将数据片段（如果数据片段中的所有行都满足表达式的话）移动到指定的磁盘（`TO DISK 'xxx'`) 或 卷（`TO VOLUME 'xxx'`）。默认的规则是移除（`DELETE`）。可以在列表中指定多个规则，但最多只能有一个`DELETE`的规则。
-    
+
     更多细节，请查看 [表和列的 TTL](#table_engine-mergetree-ttl)
 
--   `SETTINGS` — 控制 `MergeTree` 行为的额外参数：
+- `SETTINGS` — 控制 `MergeTree` 行为的额外参数，可选项：
 
-    -   `index_granularity` — 索引粒度。索引中相邻的『标记』间的数据行数。默认值，8192 。参考[数据存储](#mergetree-data-storage)。
-    -   `index_granularity_bytes` — 索引粒度，以字节为单位，默认值: 10Mb。如果想要仅按数据行数限制索引粒度, 请设置为0(不建议)。
-    -   `enable_mixed_granularity_parts` — 是否启用通过 `index_granularity_bytes` 控制索引粒度的大小。在19.11版本之前, 只有 `index_granularity` 配置能够用于限制索引粒度的大小。当从具有很大的行（几十上百兆字节）的表中查询数据时候，`index_granularity_bytes` 配置能够提升ClickHouse的性能。如果你的表里有很大的行，可以开启这项配置来提升`SELECT` 查询的性能。
-    -   `use_minimalistic_part_header_in_zookeeper` — 是否在 ZooKeeper 中启用最小的数据片段头 。如果设置了 `use_minimalistic_part_header_in_zookeeper=1` ，ZooKeeper 会存储更少的数据。更多信息参考『服务配置参数』这章中的 [设置描述](../../../operations/server-configuration-parameters/settings.md#server-settings-use_minimalistic_part_header_in_zookeeper) 。
-    -   `min_merge_bytes_to_use_direct_io` — 使用直接 I/O 来操作磁盘的合并操作时要求的最小数据量。合并数据片段时，ClickHouse 会计算要被合并的所有数据的总存储空间。如果大小超过了 `min_merge_bytes_to_use_direct_io` 设置的字节数，则 ClickHouse 将使用直接 I/O 接口（`O_DIRECT` 选项）对磁盘读写。如果设置 `min_merge_bytes_to_use_direct_io = 0` ，则会禁用直接 I/O。默认值：`10 * 1024 * 1024 * 1024` 字节。
+  - `index_granularity` — 索引粒度。索引中相邻的『标记』间的数据行数。默认值8192 。参考[数据存储](#mergetree-data-storage)。
+  - `index_granularity_bytes` — 索引粒度，以字节为单位，默认值: 10Mb。如果想要仅按数据行数限制索引粒度, 请设置为0(不建议)。
+  - `min_index_granularity_bytes` - 允许的最小数据粒度，默认值：1024b。该选项用于防止误操作，添加了一个非常低索引粒度的表。参考[数据存储](#mergetree-data-storage)
+  - `enable_mixed_granularity_parts` — 是否启用通过 `index_granularity_bytes` 控制索引粒度的大小。在19.11版本之前, 只有 `index_granularity` 配置能够用于限制索引粒度的大小。当从具有很大的行（几十上百兆字节）的表中查询数据时候，`index_granularity_bytes` 配置能够提升ClickHouse的性能。如果您的表里有很大的行，可以开启这项配置来提升`SELECT` 查询的性能。
+  - `use_minimalistic_part_header_in_zookeeper` — ZooKeeper中数据片段存储方式 。如果`use_minimalistic_part_header_in_zookeeper=1` ，ZooKeeper 会存储更少的数据。更多信息参考[服务配置参数]([Server Settings | ClickHouse Documentation](https://clickhouse.tech/docs/zh/operations/server-configuration-parameters/settings/))这章中的 [设置描述](../../../operations/server-configuration-parameters/settings.md#server-settings-use_minimalistic_part_header_in_zookeeper) 。
+  - `min_merge_bytes_to_use_direct_io` — 使用直接 I/O 来操作磁盘的合并操作时要求的最小数据量。合并数据片段时，ClickHouse 会计算要被合并的所有数据的总存储空间。如果大小超过了 `min_merge_bytes_to_use_direct_io` 设置的字节数，则 ClickHouse 将使用直接 I/O 接口（`O_DIRECT` 选项）对磁盘读写。如果设置 `min_merge_bytes_to_use_direct_io = 0` ，则会禁用直接 I/O。默认值：`10 * 1024 * 1024 * 1024` 字节。
         <a name="mergetree_setting-merge_with_ttl_timeout"></a>
-    -   `merge_with_ttl_timeout` — TTL合并频率的最小间隔时间，单位：秒。默认值: 86400 (1 天)。
-    -   `write_final_mark` — 是否启用在数据片段尾部写入最终索引标记。默认值: 1（不建议更改）。
-    -   `merge_max_block_size` — 在块中进行合并操作时的最大行数限制。默认值：8192
-    -   `storage_policy` — 存储策略。 参见 [使用具有多个块的设备进行数据存储](#table_engine-mergetree-multiple-volumes).
-    -   `min_bytes_for_wide_part`,`min_rows_for_wide_part` 在数据片段中可以使用`Wide`格式进行存储的最小字节数/行数。你可以不设置、只设置一个，或全都设置。参考：[数据存储](#mergetree-data-storage)
+  - `merge_with_ttl_timeout` — TTL合并频率的最小间隔时间，单位：秒。默认值: 86400 (1 天)。
+  - `write_final_mark` — 是否启用在数据片段尾部写入最终索引标记。默认值: 1（不要关闭）。
+  - `merge_max_block_size` — 在块中进行合并操作时的最大行数限制。默认值：8192
+  - `storage_policy` — 存储策略。 参见 [使用具有多个块的设备进行数据存储](#table_engine-mergetree-multiple-volumes).
+  - `min_bytes_for_wide_part`,`min_rows_for_wide_part` 在数据片段中可以使用`Wide`格式进行存储的最小字节数/行数。您可以不设置、只设置一个，或全都设置。参考：[数据存储](#mergetree-data-storage)
+  - `max_parts_in_total` - 所有分区中最大块的数量(意义不明)
+  - `max_compress_block_size` - 在数据压缩写入表前，未压缩数据块的最大大小。您可以在全局设置中设置该值(参见[max_compress_block_size](https://clickhouse.tech/docs/zh/operations/settings/settings/#max-compress-block-size))。建表时指定该值会覆盖全局设置。
+  - `min_compress_block_size` - 在数据压缩写入表前，未压缩数据块的最小大小。您可以在全局设置中设置该值(参见[min_compress_block_size](https://clickhouse.tech/docs/zh/operations/settings/settings/#min-compress-block-size))。建表时指定该值会覆盖全局设置。
+  - `max_partitions_to_read` - 一次查询中可访问的分区最大数。您可以在全局设置中设置该值(参见[max_partitions_to_read](https://clickhouse.tech/docs/zh/operations/settings/settings/#max_partitions_to_read))。
 
 **示例配置**
 
@@ -107,12 +111,11 @@ ENGINE MergeTree() PARTITION BY toYYYYMM(EventDate) ORDER BY (CounterID, EventDa
 
 在这个例子中，我们设置了按月进行分区。
 
-同时我们设置了一个按用户 ID 哈希的抽样表达式。这使得你可以对该表中每个 `CounterID` 和 `EventDate` 的数据伪随机分布。如果你在查询时指定了 [SAMPLE](../../../engines/table-engines/mergetree-family/mergetree.md#select-sample-clause) 子句。 ClickHouse会返回对于用户子集的一个均匀的伪随机数据采样。
+同时我们设置了一个按用户 ID 哈希的抽样表达式。这使得您可以对该表中每个 `CounterID` 和 `EventDate` 的数据伪随机分布。如果您在查询时指定了 [SAMPLE](../../../engines/table-engines/mergetree-family/mergetree.md#select-sample-clause) 子句。 ClickHouse会返回对于用户子集的一个均匀的伪随机数据采样。
 
 `index_granularity` 可省略因为 8192 是默认设置 。
 
 <details markdown="1">
-
 <summary>已弃用的建表方法</summary>
 
 !!! attention "注意"
@@ -127,10 +130,10 @@ ENGINE MergeTree() PARTITION BY toYYYYMM(EventDate) ORDER BY (CounterID, EventDa
 
 **MergeTree() 参数**
 
--   `date-column` — 类型为 [日期](../../../engines/table-engines/mergetree-family/mergetree.md) 的列名。ClickHouse 会自动依据这个列按月创建分区。分区名格式为 `"YYYYMM"` 。
--   `sampling_expression` — 采样表达式。
--   `(primary, key)` — 主键。类型 — [元组()](../../../engines/table-engines/mergetree-family/mergetree.md)
--   `index_granularity` — 索引粒度。即索引中相邻『标记』间的数据行数。设为 8192 可以适用大部分场景。
+- `date-column` — 类型为 [日期](../../../engines/table-engines/mergetree-family/mergetree.md) 的列名。ClickHouse 会自动依据这个列按月创建分区。分区名格式为 `"YYYYMM"` 。
+- `sampling_expression` — 采样表达式。
+- `(primary, key)` — 主键。类型 — [元组()](../../../engines/table-engines/mergetree-family/mergetree.md)
+- `index_granularity` — 索引粒度。即索引中相邻『标记』间的数据行数。设为 8192 可以适用大部分场景。
 
 **示例**
 
@@ -152,51 +155,55 @@ ENGINE MergeTree() PARTITION BY toYYYYMM(EventDate) ORDER BY (CounterID, EventDa
 数据存储格式由 `min_bytes_for_wide_part` 和 `min_rows_for_wide_part` 表引擎参数控制。如果数据片段中的字节数或行数少于相应的设置值，数据片段会以 `Compact` 格式存储，否则会以 `Wide` 格式存储。
 
 每个数据片段被逻辑的分割成颗粒（granules）。颗粒是 ClickHouse 中进行数据查询时的最小不可分割数据集。ClickHouse 不会对行或值进行拆分，所以每个颗粒总是包含整数个行。每个颗粒的第一行通过该行的主键值进行标记，
-ClickHouse 会为每个数据片段创建一个索引文件来存储这些标记。对于每列，无论它是否包含在主键当中，ClickHouse 都会存储类似标记。这些标记让你可以在列文件中直接找到数据。
+ClickHouse 会为每个数据片段创建一个索引文件来存储这些标记。对于每列，无论它是否包含在主键当中，ClickHouse 都会存储类似标记。这些标记让您可以在列文件中直接找到数据。
 
-颗粒的大小通过表引擎参数 `index_granularity` 和 `index_granularity_bytes` 控制。取决于行的大小，颗粒的行数的在 `[1, index_granularity]` 范围中。如果单行的大小超过了 `index_granularity_bytes` 设置的值，那么一个颗粒的大小会超过 `index_granularity_bytes`。在这种情况下，颗粒的大小等于该行的大小。 
+颗粒的大小通过表引擎参数 `index_granularity` 和 `index_granularity_bytes` 控制。颗粒的行数的在 `[1, index_granularity]` 范围中，这取决于行的大小。如果单行的大小超过了 `index_granularity_bytes` 设置的值，那么一个颗粒的大小会超过 `index_granularity_bytes`。在这种情况下，颗粒的大小等于该行的大小。
 
 ## 主键和索引在查询中的表现 {#primary-keys-and-indexes-in-queries}
 
 我们以 `(CounterID, Date)` 以主键。排序好的索引的图示会是下面这样：
 
+``` text
     全部数据  :     [-------------------------------------------------------------------------]
     CounterID:      [aaaaaaaaaaaaaaaaaabbbbcdeeeeeeeeeeeeefgggggggghhhhhhhhhiiiiiiiiikllllllll]
     Date:           [1111111222222233331233211111222222333211111112122222223111112223311122333]
     标记:            |      |      |      |      |      |      |      |      |      |      |
                     a,1    a,2    a,3    b,3    e,2    e,3    g,1    h,2    i,1    i,3    l,3
     标记号:          0      1      2      3      4      5      6      7      8      9      10
+```
 
 如果指定查询如下：
 
--   `CounterID in ('a', 'h')`，服务器会读取标记号在 `[0, 3)` 和 `[6, 8)` 区间中的数据。
--   `CounterID IN ('a', 'h') AND Date = 3`，服务器会读取标记号在 `[1, 3)` 和 `[7, 8)` 区间中的数据。
--   `Date = 3`，服务器会读取标记号在 `[1, 10]` 区间中的数据。
+- `CounterID in ('a', 'h')`，服务器会读取标记号在 `[0, 3)` 和 `[6, 8)` 区间中的数据。
+- `CounterID IN ('a', 'h') AND Date = 3`，服务器会读取标记号在 `[1, 3)` 和 `[7, 8)` 区间中的数据。
+- `Date = 3`，服务器会读取标记号在 `[1, 10]` 区间中的数据。
 
 上面例子可以看出使用索引通常会比全表描述要高效。
 
 稀疏索引会引起额外的数据读取。当读取主键单个区间范围的数据时，每个数据块中最多会多读 `index_granularity * 2` 行额外的数据。
 
-稀疏索引使得你可以处理极大量的行，因为大多数情况下，这些索引常驻与内存（RAM）中。
+稀疏索引使得您可以处理极大量的行，因为大多数情况下，这些索引常驻于内存。
 
-ClickHouse 不要求主键惟一，所以你可以插入多条具有相同主键的行。
+ClickHouse 不要求主键唯一，所以您可以插入多条具有相同主键的行。
+
+您可以在`PRIMARY KEY`与`ORDER BY`条件中使用`可为空的`类型的表达式，但强烈建议不要这么做。为了启用这项功能，请打开[allow_nullable_key](https://clickhouse.tech/docs/zh/operations/settings/settings/#allow-nullable-key)，[NULLS_LAST](https://clickhouse.tech/docs/zh/sql-reference/statements/select/order-by/#sorting-of-special-values)规则也适用于`ORDER BY`条件中有NULL值的情况下。
 
 ### 主键的选择 {#zhu-jian-de-xuan-ze}
 
-主键中列的数量并没有明确的限制。依据数据结构，你可以在主键包含多些或少些列。这样可以：
+主键中列的数量并没有明确的限制。依据数据结构，您可以在主键包含多些或少些列。这样可以：
 
--   改善索引的性能。
+- 改善索引的性能。
 
     如果当前主键是 `(a, b)` ，在下列情况下添加另一个 `c` 列会提升性能：
-    
-    - 查询会使用 `c` 列作为条件
-    - 很长的数据范围（ `index_granularity` 的数倍）里 `(a, b)` 都是相同的值，并且这样的情况很普遍。换言之，就是加入另一列后，可以让你的查询略过很长的数据范围。
 
--   改善数据压缩。
+  - 查询会使用 `c` 列作为条件
+  - 很长的数据范围（ `index_granularity` 的数倍）里 `(a, b)` 都是相同的值，并且这样的情况很普遍。换言之，就是加入另一列后，可以让您的查询略过很长的数据范围。
+
+- 改善数据压缩。
 
     ClickHouse 以主键排序片段数据，所以，数据的一致性越高，压缩越好。
 
--   在[CollapsingMergeTree](collapsingmergetree.md#table_engine-collapsingmergetree) 和 [SummingMergeTree](summingmergetree.md) 引擎里进行数据合并时会提供额外的处理逻辑。
+- 在[CollapsingMergeTree](collapsingmergetree.md#table_engine-collapsingmergetree) 和 [SummingMergeTree](summingmergetree.md) 引擎里进行数据合并时会提供额外的处理逻辑。
 
     在这种情况下，指定与主键不同的 *排序键* 也是有意义的。
 
@@ -206,9 +213,9 @@ ClickHouse 不要求主键惟一，所以你可以插入多条具有相同主键
 
 想要根据初始顺序进行数据查询，使用 [单线程查询](../../../operations/settings/settings.md#settings-max_threads)
 
-### 选择与排序键不同主键 {#choosing-a-primary-key-that-differs-from-the-sorting-key}
+### 选择与排序键不同的主键 {#choosing-a-primary-key-that-differs-from-the-sorting-key}
 
-指定一个跟排序键不一样的主键是可以的，此时排序键用于在数据片段中进行排序，主键用于在索引文件中进行标记的写入。这种情况下，主键表达式元组必须是排序键表达式元组的前缀。
+Clickhouse可以做到指定一个跟排序键不一样的主键，此时排序键用于在数据片段中进行排序，主键用于在索引文件中进行标记的写入。这种情况下，主键表达式元组必须是排序键表达式元组的前缀(即主键为(a,b)，排序列必须为(a,b,******))。
 
 当使用 [SummingMergeTree](summingmergetree.md) 和 [AggregatingMergeTree](aggregatingmergetree.md) 引擎时，这个特性非常有用。通常在使用这类引擎时，表里的列分两种：*维度* 和 *度量* 。典型的查询会通过任意的 `GROUP BY` 对度量列进行聚合并通过维度列进行过滤。由于 SummingMergeTree 和 AggregatingMergeTree 会对排序键相同的行进行聚合，所以把所有的维度放进排序键是很自然的做法。但这将导致排序键中包含大量的列，并且排序键会伴随着新添加的维度不断的更新。
 
@@ -218,14 +225,20 @@ ClickHouse 不要求主键惟一，所以你可以插入多条具有相同主键
 
 ### 索引和分区在查询中的应用 {#use-of-indexes-and-partitions-in-queries}
 
-对于 `SELECT` 查询，ClickHouse 分析是否可以使用索引。如果 `WHERE/PREWHERE` 子句具有下面这些表达式（作为谓词链接一子项或整个）则可以使用索引：包含一个表示与主键/分区键中的部分字段或全部字段相等/不等的比较表达式；基于主键/分区键的字段上的 `IN` 或 固定前缀的`LIKE` 表达式；基于主键/分区键的字段上的某些函数；基于主键/分区键的表达式的逻辑表达式。 <!-- It is too hard for me to translate this section as the original text completely. So I did it with my own understanding. If you have good idea, please help me. -->
+对于 `SELECT` 查询，ClickHouse 分析是否可以使用索引。如果 `WHERE/PREWHERE` 子句具有下面这些表达式（作为完整WHERE条件的一部分或全部）则可以使用索引：进行相等/不相等的比较；对主键列或分区列进行`IN`运算、有固定前缀的`LIKE`运算(如name like 'test%')、函数运算(部分函数适用)，还有对上述表达式进行逻辑运算。
+
+ <!-- It is too hard for me to translate this section as the original text completely. So I did it with my own understanding. If you have good idea, please help me. -->
 <!-- It is hard for me to translate this section too, but I think change the sentence struct is helpful for understanding. So I change the phraseology-->
 
-因此，在索引键的一个或多个区间上快速地执行查询都是可能的。下面例子中，指定标签；指定标签和日期范围；指定标签和日期；指定多个标签和日期范围等执行查询，都会非常快。
+<!--I try to translate it in Chinese,don't worry. -->
+
+因此，在索引键的一个或多个区间上快速地执行查询是可能的。下面例子中，指定标签；指定标签和日期范围；指定标签和日期；指定多个标签和日期范围等执行查询，都会非常快。
 
 当引擎配置如下时：
 
+``` sql
     ENGINE MergeTree() PARTITION BY toYYYYMM(EventDate) ORDER BY (CounterID, EventDate) SETTINGS index_granularity=8192
+```
 
 这种情况下，这些查询：
 
@@ -237,7 +250,7 @@ SELECT count() FROM table WHERE ((EventDate >= toDate('2014-01-01') AND EventDat
 
 ClickHouse 会依据主键索引剪掉不符合的数据，依据按月分区的分区键剪掉那些不包含符合数据的分区。
 
-上文的查询显示，即使索引用于复杂表达式。因为读表操作是组织好的，所以，使用索引不会比完整扫描慢。
+上文的查询显示，即使索引用于复杂表达式，因为读表操作经过优化，所以使用索引不会比完整扫描慢。
 
 下面这个例子中，不会使用索引。
 
@@ -247,17 +260,16 @@ SELECT count() FROM table WHERE CounterID = 34 OR URL LIKE '%upyachka%'
 
 要检查 ClickHouse 执行一个查询时能否使用索引，可设置 [force_index_by_date](../../../operations/settings/settings.md#settings-force_index_by_date) 和 [force_primary_key](../../../operations/settings/settings.md) 。
 
-按月分区的分区键是只能读取包含适当范围日期的数据块。这种情况下，数据块会包含很多天（最多整月）的数据。在块中，数据按主键排序，主键第一列可能不包含日期。因此，仅使用日期而没有带主键前几个字段作为条件的查询将会导致需要读取超过这个指定日期以外的数据。
+使用按月分区的分区列允许只读取包含适当日期区间的数据块，这种情况下，数据块会包含很多天（最多整月）的数据。在块中，数据按主键排序，主键第一列可能不包含日期。因此，仅使用日期而没有用主键字段作为条件的查询将会导致需要读取超过这个指定日期以外的数据。
 
 ### 部分单调主键的使用
 
-考虑这样的场景，比如一个月中的几天。它们在一个月的范围内形成一个[单调序列](https://zh.wikipedia.org/wiki/单调函数) ，但如果扩展到更大的时间范围它们就不再单调了。这就是一个部分单调序列。如果用户使用部分单调的主键创建表，ClickHouse同样会创建一个稀疏索引。当用户从这类表中查询数据时，ClickHouse 会对查询条件进行分析。如果用户希望获取两个索引标记之间的数据并且这两个标记在一个月以内，ClickHouse 可以在这种特殊情况下使用到索引，因为它可以计算出查询参数与索引标记之间的距离。
+考虑这样的场景，比如一个月中的天数。它们在一个月的范围内形成一个[单调序列](https://zh.wikipedia.org/wiki/单调函数) ，但如果扩展到更大的时间范围它们就不再单调了。这就是一个部分单调序列。如果用户使用部分单调的主键创建表，ClickHouse同样会创建一个稀疏索引。当用户从这类表中查询数据时，ClickHouse 会对查询条件进行分析。如果用户希望获取两个索引标记之间的数据并且这两个标记在一个月以内，ClickHouse 可以在这种特殊情况下使用到索引，因为它可以计算出查询参数与索引标记之间的距离。
 
 如果查询参数范围内的主键不是单调序列，那么 ClickHouse 无法使用索引。在这种情况下，ClickHouse 会进行全表扫描。
 
 ClickHouse 在任何主键代表一个部分单调序列的情况下都会使用这个逻辑。
 
-
 ### 跳数索引 {#tiao-shu-suo-yin-fen-duan-hui-zong-suo-yin-shi-yan-xing-de}
 
 此索引在 `CREATE` 语句的列部分里定义。
@@ -267,11 +279,7 @@ INDEX index_name expr TYPE type(...) GRANULARITY granularity_value
 ```
 
 `*MergeTree` 系列的表可以指定跳数索引。
-
-这些索引是由数据块按粒度分割后的每部分在指定表达式上汇总信息 `granularity_value` 组成（粒度大小用表引擎里 `index_granularity` 的指定）。
-这些汇总信息有助于用 `where` 语句跳过大片不满足的数据，从而减少 `SELECT` 查询从磁盘读取的数据量，
-
-这些索引会在数据块上聚合指定表达式的信息，这些信息以 granularity_value 指定的粒度组成 （粒度的大小通过在表引擎中定义 index_granularity 定义）。这些汇总信息有助于跳过大片不满足 `where` 条件的数据，从而减少 `SELECT` 查询从磁盘读取的数据量。
+跳数索引是指数据片段按照粒度(建表时指定的`index_granularity`)分割成小块后，将上述SQL的granularity_value数量的小块组合成一个大的块，对这些大块写入索引信息，这样有助于使用`where`筛选时跳过大量不必要的数据，减少`SELECT`需要读取的数据量。
 
 **示例**
 
@@ -295,34 +303,32 @@ SELECT count() FROM table WHERE s < 'z'
 SELECT count() FROM table WHERE u64 * i32 == 10 AND u64 * length(s) >= 1234
 ```
 
-#### 索引的可用类型 {#table_engine-mergetree-data_skipping-indexes}
+#### 可用的索引类型 {#table_engine-mergetree-data_skipping-indexes}
 
--   `minmax`
+- `minmax`
     存储指定表达式的极值（如果表达式是 `tuple` ，则存储 `tuple` 中每个元素的极值），这些信息用于跳过数据块，类似主键。
 
--   `set(max_rows)`
-    存储指定表达式的不重复值（不超过 `max_rows` 个，`max_rows=0` 则表示『无限制』）。这些信息可用于检查 数据块是否满足 `WHERE` 条件。
+- `set(max_rows)`
+    存储指定表达式的不重复值（不超过 `max_rows` 个，`max_rows=0` 则表示『无限制』）。这些信息可用于检查数据块是否满足 `WHERE` 条件。
 
--   `ngrambf_v1(n, size_of_bloom_filter_in_bytes, number_of_hash_functions, random_seed)`
+- `ngrambf_v1(n, size_of_bloom_filter_in_bytes, number_of_hash_functions, random_seed)`
     存储一个包含数据块中所有 n元短语（ngram） 的 [布隆过滤器](https://en.wikipedia.org/wiki/Bloom_filter) 。只可用在字符串上。
     可用于优化 `equals` ， `like` 和 `in` 表达式的性能。
-    `n` – 短语长度。
-    `size_of_bloom_filter_in_bytes` – 布隆过滤器大小，单位字节。（因为压缩得好，可以指定比较大的值，如 256 或 512）。
-    `number_of_hash_functions` – 布隆过滤器中使用的哈希函数的个数。
-    `random_seed` – 哈希函数的随机种子。
+  - `n` – 短语长度。
+  - `size_of_bloom_filter_in_bytes` – 布隆过滤器大小，字节为单位。（因为压缩得好，可以指定比较大的值，如 256 或 512）。
+  - `number_of_hash_functions` – 布隆过滤器中使用的哈希函数的个数。
+  - `random_seed` – 哈希函数的随机种子。
 
--   `tokenbf_v1(size_of_bloom_filter_in_bytes, number_of_hash_functions, random_seed)`
-    跟 `ngrambf_v1` 类似，不同于 ngrams 存储字符串指定长度的所有片段。它只存储被非字母数字字符分割的片段。
+- `tokenbf_v1(size_of_bloom_filter_in_bytes, number_of_hash_functions, random_seed)`
+    跟 `ngrambf_v1` 类似，但是存储的是token而不是ngrams。Token是由非字母数字的符号分割的序列。
 
--   `bloom_filter(bloom_filter([false_positive])` – 为指定的列存储布隆过滤器
+- `bloom_filter(bloom_filter([false_positive])` – 为指定的列存储布隆过滤器
+
+    可选参数`false_positive`用来指定从布隆过滤器收到错误响应的几率。取值范围是 (0,1)，默认值：0.025
 
-    可选的参数 false_positive 用来指定从布隆过滤器收到错误响应的几率。取值范围是 (0,1)，默认值：0.025
-    
     支持的数据类型：`Int*`, `UInt*`, `Float*`, `Enum`, `Date`, `DateTime`, `String`, `FixedString`, `Array`, `LowCardinality`, `Nullable`。
-    
+
     以下函数会用到这个索引： [equals](../../../sql-reference/functions/comparison-functions.md), [notEquals](../../../sql-reference/functions/comparison-functions.md), [in](../../../sql-reference/functions/in-functions.md), [notIn](../../../sql-reference/functions/in-functions.md), [has](../../../sql-reference/functions/array-functions.md)
-    
-<!-- -->
 
 ``` sql
 INDEX sample_index (u64 * length(s)) TYPE minmax GRANULARITY 4
@@ -332,56 +338,56 @@ INDEX sample_index3 (lower(str), str) TYPE ngrambf_v1(3, 256, 2, 0) GRANULARITY
 
 #### 函数支持 {#functions-support}
 
-WHERE 子句中的条件包含对列的函数调用，如果列是索引的一部分，ClickHouse 会在执行函数时尝试使用索引。不同的函数对索引的支持是不同的。
+WHERE 子句中的条件可以包含对某列数据进行运算的函数表达式，如果列是索引的一部分，ClickHouse会在执行函数时尝试使用索引。不同的函数对索引的支持是不同的。
 
 `set` 索引会对所有函数生效，其他索引对函数的生效情况见下表
 
-| 函数 (操作符) / 索引                                                                                | primary key | minmax | ngrambf_v1 | tokenbf_v1 | bloom_filter |
-|------------------------------------------------------------------------------------------------------------|-------------|--------|-------------|-------------|---------------|
-| [equals (=, ==)](../../../sql-reference/functions/comparison-functions.md#function-equals)                 | ✔           | ✔      | ✔           | ✔           | ✔             |
-| [notEquals(!=, \<\>)](../../../sql-reference/functions/comparison-functions.md#function-notequals)         | ✔           | ✔      | ✔           | ✔           | ✔             |
-| [like](../../../sql-reference/functions/string-search-functions.md#function-like)                          | ✔           | ✔      | ✔           | ✔           | ✔             |
-| [notLike](../../../sql-reference/functions/string-search-functions.md#function-notlike)                    | ✔           | ✔      | ✗           | ✗           | ✗             |
-| [startsWith](../../../sql-reference/functions/string-functions.md#startswith)                              | ✔           | ✔      | ✔           | ✔           | ✗             |
-| [endsWith](../../../sql-reference/functions/string-functions.md#endswith)                                  | ✗           | ✗      | ✔           | ✔           | ✗             |
-| [multiSearchAny](../../../sql-reference/functions/string-search-functions.md#function-multisearchany)      | ✗           | ✗      | ✔           | ✗           | ✗             |
-| [in](../../../sql-reference/functions/in-functions.md#in-functions)                                        | ✔           | ✔      | ✔           | ✔           | ✔             |
-| [notIn](../../../sql-reference/functions/in-functions.md#in-functions)                                     | ✔           | ✔      | ✔           | ✔           | ✔             |
-| [less (\<)](../../../sql-reference/functions/comparison-functions.md#function-less)                        | ✔           | ✔      | ✗           | ✗           | ✗             |
-| [greater (\>)](../../../sql-reference/functions/comparison-functions.md#function-greater)                  | ✔           | ✔      | ✗           | ✗           | ✗             |
-| [lessOrEquals (\<=)](../../../sql-reference/functions/comparison-functions.md#function-lessorequals)       | ✔           | ✔      | ✗           | ✗           | ✗             |
-| [greaterOrEquals (\>=)](../../../sql-reference/functions/comparison-functions.md#function-greaterorequals) | ✔           | ✔      | ✗           | ✗           | ✗             |
-| [empty](../../../sql-reference/functions/array-functions.md#function-empty)                                | ✔           | ✔      | ✗           | ✗           | ✗             |
-| [notEmpty](../../../sql-reference/functions/array-functions.md#function-notempty)                          | ✔           | ✔      | ✗           | ✗           | ✗             |
-| hasToken                                                                                                   | ✗           | ✗      | ✗           | ✔           | ✗             |
+| 函数 (操作符) / 索引                                         | primary key | minmax | ngrambf_v1 | tokenbf_v1 | bloom_filter |
+| ------------------------------------------------------------ | ----------- | ------ | ---------- | ---------- | ------------ |
+| [equals (=, ==)](../../../sql-reference/functions/comparison-functions.md#function-equals) | ✔           | ✔      | ✔          | ✔          | ✔            |
+| [notEquals(!=, \<\>)](../../../sql-reference/functions/comparison-functions.md#function-notequals) | ✔           | ✔      | ✔          | ✔          | ✔            |
+| [like](../../../sql-reference/functions/string-search-functions.md#function-like) | ✔           | ✔      | ✔          | ✔          | ✔            |
+| [notLike](../../../sql-reference/functions/string-search-functions.md#function-notlike) | ✔           | ✔      | ✗          | ✗          | ✗            |
+| [startsWith](../../../sql-reference/functions/string-functions.md#startswith) | ✔           | ✔      | ✔          | ✔          | ✗            |
+| [endsWith](../../../sql-reference/functions/string-functions.md#endswith) | ✗           | ✗      | ✔          | ✔          | ✗            |
+| [multiSearchAny](../../../sql-reference/functions/string-search-functions.md#function-multisearchany) | ✗           | ✗      | ✔          | ✗          | ✗            |
+| [in](../../../sql-reference/functions/in-functions.md#in-functions) | ✔           | ✔      | ✔          | ✔          | ✔            |
+| [notIn](../../../sql-reference/functions/in-functions.md#in-functions) | ✔           | ✔      | ✔          | ✔          | ✔            |
+| [less (\<)](../../../sql-reference/functions/comparison-functions.md#function-less) | ✔           | ✔      | ✗          | ✗          | ✗            |
+| [greater (\>)](../../../sql-reference/functions/comparison-functions.md#function-greater) | ✔           | ✔      | ✗          | ✗          | ✗            |
+| [lessOrEquals (\<=)](../../../sql-reference/functions/comparison-functions.md#function-lessorequals) | ✔           | ✔      | ✗          | ✗          | ✗            |
+| [greaterOrEquals (\>=)](../../../sql-reference/functions/comparison-functions.md#function-greaterorequals) | ✔           | ✔      | ✗          | ✗          | ✗            |
+| [empty](../../../sql-reference/functions/array-functions.md#function-empty) | ✔           | ✔      | ✗          | ✗          | ✗            |
+| [notEmpty](../../../sql-reference/functions/array-functions.md#function-notempty) | ✔           | ✔      | ✗          | ✗          | ✗            |
+| hasToken                                                     | ✗           | ✗      | ✗          | ✔          | ✗            |
 
 常量参数小于 ngram 大小的函数不能使用 `ngrambf_v1` 进行查询优化。
 
 !!! note "注意"
-布隆过滤器可能会包含不符合条件的匹配，所以 `ngrambf_v1`, `tokenbf_v1` 和 `bloom_filter` 索引不能用于负向的函数，例如：
+布隆过滤器可能会包含不符合条件的匹配，所以 `ngrambf_v1`, `tokenbf_v1` 和 `bloom_filter` 索引不能用于结果返回为假的函数，例如：
 
--   可以用来优化的场景
-    -   `s LIKE '%test%'`
-    -   `NOT s NOT LIKE '%test%'`
-    -   `s = 1`
-    -   `NOT s != 1`
-    -   `startsWith(s, 'test')`
--   不能用来优化的场景
-    -   `NOT s LIKE '%test%'`
-    -   `s NOT LIKE '%test%'`
-    -   `NOT s = 1`
-    -   `s != 1`
-    -   `NOT startsWith(s, 'test')`
+- 可以用来优化的场景
+  - `s LIKE '%test%'`
+  - `NOT s NOT LIKE '%test%'`
+  - `s = 1`
+  - `NOT s != 1`
+  - `startsWith(s, 'test')`
+- 不能用来优化的场景
+  - `NOT s LIKE '%test%'`
+  - `s NOT LIKE '%test%'`
+  - `NOT s = 1`
+  - `s != 1`
+  - `NOT startsWith(s, 'test')`
 
 ## 并发数据访问 {#concurrent-data-access}
 
-应对表的并发访问，我们使用多版本机制。换言之，当同时读和更新表时，数据从当前查询到的一组片段中读取。没有冗长的的锁。插入不会阻碍读取。
+对于表的并发访问，我们使用多版本机制。换言之，当一张表同时被读和更新时，数据从当前查询到的一组片段中读取。没有冗长的的锁。插入不会阻碍读取。
 
 对表的读操作是自动并行的。
 
 ## 列和表的 TTL {#table_engine-mergetree-ttl}
 
-TTL 可以设置值的生命周期，它既可以为整张表设置，也可以为每个列字段单独设置。表级别的 TTL 还会指定数据在磁盘和卷上自动转移的逻辑。
+TTL用于设置值的生命周期，它既可以为整张表设置，也可以为每个列字段单独设置。表级别的 TTL 还会指定数据在磁盘和卷上自动转移的逻辑。
 
 TTL 表达式的计算结果必须是 [日期](../../../engines/table-engines/mergetree-family/mergetree.md) 或 [日期时间](../../../engines/table-engines/mergetree-family/mergetree.md) 类型的字段。
 
@@ -405,7 +411,7 @@ TTL date_time + INTERVAL 15 HOUR
 
 `TTL`子句不能被用于主键字段。
 
-示例:
+**示例:**
 
 创建表时指定 `TTL`
 
@@ -443,16 +449,23 @@ ALTER TABLE example_table
 表可以设置一个用于移除过期行的表达式，以及多个用于在磁盘或卷上自动转移数据片段的表达式。当表中的行过期时，ClickHouse 会删除所有对应的行。对于数据片段的转移特性，必须所有的行都满足转移条件。
 
 ``` sql
-TTL expr [DELETE|TO DISK 'aaa'|TO VOLUME 'bbb'], ...
+TTL expr
+    [DELETE|TO DISK 'xxx'|TO VOLUME 'xxx'][, DELETE|TO DISK 'aaa'|TO VOLUME 'bbb'] ...
+    [WHERE conditions]
+    [GROUP BY key_expr [SET v1 = aggr_func(v1) [, v2 = aggr_func(v2) ...]] ]
+
 ```
 
 TTL 规则的类型紧跟在每个 TTL 表达式后面，它会影响满足表达式时（到达指定时间时）应当执行的操作：
 
--   `DELETE` - 删除过期的行（默认操作）;
--   `TO DISK 'aaa'` - 将数据片段移动到磁盘 `aaa`;
--   `TO VOLUME 'bbb'` - 将数据片段移动到卷 `bbb`.
+- `DELETE` - 删除过期的行（默认操作）;
+- `TO DISK 'aaa'` - 将数据片段移动到磁盘 `aaa`;
+- `TO VOLUME 'bbb'` - 将数据片段移动到卷 `bbb`.
+- `GROUP BY` - 聚合过期的行
 
-示例:
+使用`WHERE`从句，您可以指定哪些过期的行会被删除或聚合(不适用于移动)。`GROUP BY`表达式必须是表主键的前缀。如果某列不是`GROUP BY`表达式的一部分，也没有在SET从句显示引用，结果行中相应列的值是随机的(就好像使用了`any`函数)。
+
+**示例**:
 
 创建时指定 TTL
 
@@ -477,19 +490,49 @@ ALTER TABLE example_table
     MODIFY TTL d + INTERVAL 1 DAY;
 ```
 
+创建一张表，设置一个月后数据过期，这些过期的行中日期为星期一的删除：
+
+``` sql
+CREATE TABLE table_with_where
+(
+    d DateTime,
+    a Int
+)
+ENGINE = MergeTree
+PARTITION BY toYYYYMM(d)
+ORDER BY d
+TTL d + INTERVAL 1 MONTH DELETE WHERE toDayOfWeek(d) = 1;
+```
+
+创建一张表，设置过期的列会被聚合。列`x`包含每组行中的最大值，`y`为最小值，`d`为可能任意值。
+
+``` sql
+CREATE TABLE table_for_aggregation
+(
+    d DateTime,
+    k1 Int,
+    k2 Int,
+    x Int,
+    y Int
+)
+ENGINE = MergeTree
+ORDER BY (k1, k2)
+TTL d + INTERVAL 1 MONTH GROUP BY k1, k2 SET x = max(x), y = min(y);
+```
+
 **删除数据**
 
 ClickHouse 在数据片段合并时会删除掉过期的数据。
 
-当ClickHouse发现数据过期时, 它将会执行一个计划外的合并。要控制这类合并的频率, 你可以设置 `merge_with_ttl_timeout`。如果该值被设置的太低, 它将引发大量计划外的合并，这可能会消耗大量资源。
+当ClickHouse发现数据过期时, 它将会执行一个计划外的合并。要控制这类合并的频率, 您可以设置 `merge_with_ttl_timeout`。如果该值被设置的太低, 它将引发大量计划外的合并，这可能会消耗大量资源。
 
-如果在合并的过程中执行 `SELECT` 查询, 则可能会得到过期的数据。为了避免这种情况，可以在 `SELECT` 之前使用 [OPTIMIZE](../../../engines/table-engines/mergetree-family/mergetree.md#misc_operations-optimize) 查询。
+如果在合并的过程中执行 `SELECT` 查询, 则可能会得到过期的数据。为了避免这种情况，可以在 `SELECT` 之前使用 [OPTIMIZE](../../../engines/table-engines/mergetree-family/mergetree.md#misc_operations-optimize) 。
 
-## 使用具有多个块的设备进行数据存储 {#table_engine-mergetree-multiple-volumes}
+## 使用多个块设备进行数据存储 {#table_engine-mergetree-multiple-volumes}
 
 ### 介绍 {#introduction}
 
-MergeTree 系列表引擎可以将数据存储在多块设备上。这对某些可以潜在被划分为“冷”“热”的表来说是很有用的。近期数据被定期的查询但只需要很小的空间。相反，详尽的历史数据很少被用到。如果有多块磁盘可用，那么“热”的数据可以放置在快速的磁盘上（比如 NVMe 固态硬盘或内存），“冷”的数据可以放在相对较慢的磁盘上（比如机械硬盘）。
+MergeTree 系列表引擎可以将数据存储在多个块设备上。这对某些可以潜在被划分为“冷”“热”的表来说是很有用的。最新数据被定期的查询但只需要很小的空间。相反，详尽的历史数据很少被用到。如果有多块磁盘可用，那么“热”的数据可以放置在快速的磁盘上（比如 NVMe 固态硬盘或内存），“冷”的数据可以放在相对较慢的磁盘上（比如机械硬盘）。
 
 数据片段是 `MergeTree` 引擎表的最小可移动单元。属于同一个数据片段的数据被存储在同一块磁盘上。数据片段会在后台自动的在磁盘间移动，也可以通过 [ALTER](../../../sql-reference/statements/alter.md#alter_move-partition) 查询来移动。
 
@@ -497,12 +540,14 @@ MergeTree 系列表引擎可以将数据存储在多块设备上。这对某些
 
 - 磁盘 — 挂载到文件系统的块设备
 - 默认磁盘 — 在服务器设置中通过 [path](../../../operations/server-configuration-parameters/settings.md#server_configuration_parameters-path) 参数指定的数据存储
-- 卷 — 磁盘的等效有序集合 （类似于 [JBOD](https://en.wikipedia.org/wiki/Non-RAID_drive_architectures)）
+- 卷 — 相同磁盘的顺序列表 （类似于 [JBOD](https://en.wikipedia.org/wiki/Non-RAID_drive_architectures)）
 - 存储策略 — 卷的集合及他们之间的数据移动规则
 
+ 以上名称的信息在Clickhouse中系统表[system.storage_policies](https://clickhouse.tech/docs/zh/operations/system-tables/storage_policies/#system_tables-storage_policies)和[system.disks](https://clickhouse.tech/docs/zh/operations/system-tables/disks/#system_tables-disks)体现。为了应用存储策略，可以在建表时使用`storage_policy`设置。
+
 ### 配置 {#table_engine-mergetree-multiple-volumes_configure}
 
-磁盘、卷和存储策略应当在主文件 `config.xml` 或 `config.d` 目录中的独立文件中的 `<storage_configuration>` 标签内定义。
+磁盘、卷和存储策略应当在主配置文件 `config.xml` 或 `config.d` 目录中的独立文件中的 `<storage_configuration>` 标签内定义。
 
 配置结构：
 
@@ -530,9 +575,9 @@ MergeTree 系列表引擎可以将数据存储在多块设备上。这对某些
 
 标签：
 
--   `<disk_name_N>` — 磁盘名，名称必须与其他磁盘不同.
--   `path` — 服务器将用来存储数据 (`data` 和 `shadow` 目录) 的路径, 应当以 ‘/’ 结尾.
--   `keep_free_space_bytes` — 需要保留的剩余磁盘空间.
+- `<disk_name_N>` — 磁盘名，名称必须与其他磁盘不同.
+- `path` — 服务器将用来存储数据 (`data` 和 `shadow` 目录) 的路径, 应当以 ‘/’ 结尾.
+- `keep_free_space_bytes` — 需要保留的剩余磁盘空间.
 
 磁盘定义的顺序无关紧要。
 
@@ -567,11 +612,12 @@ MergeTree 系列表引擎可以将数据存储在多块设备上。这对某些
 
 标签：
 
--   `policy_name_N` — 策略名称，不能重复。
--   `volume_name_N` — 卷名称，不能重复。
--   `disk` — 卷中的磁盘。
--   `max_data_part_size_bytes` — 任意卷上的磁盘可以存储的数据片段的最大大小。
--   `move_factor` — 当可用空间少于这个因子时，数据将自动的向下一个卷（如果有的话）移动 (默认值为 0.1)。
+- `policy_name_N` — 策略名称，不能重复。
+- `volume_name_N` — 卷名称，不能重复。
+- `disk` — 卷中的磁盘。
+- `max_data_part_size_bytes` — 卷中的磁盘可以存储的数据片段的最大大小。
+- `move_factor` — 当可用空间少于这个因子时，数据将自动的向下一个卷（如果有的话）移动 (默认值为 0.1)。
+- `prefer_not_to_merge` - 禁止在这个卷中进行数据合并。该选项启用时，对该卷的数据不能进行合并。这个选项主要用于慢速磁盘。
 
 配置示例：
 
@@ -600,19 +646,31 @@ MergeTree 系列表引擎可以将数据存储在多块设备上。这对某些
             </volumes>
             <move_factor>0.2</move_factor>
         </moving_from_ssd_to_hdd>
+
+        <small_jbod_with_external_no_merges>
+            <volumes>
+                <main>
+                    <disk>jbod1</disk>
+                </main>
+                <external>
+                    <disk>external</disk>
+                    <prefer_not_to_merge>true</prefer_not_to_merge>
+                </external>
+            </volumes>
+        </small_jbod_with_external_no_merges>
     </policies>
     ...
 </storage_configuration>
 ```
 
-在给出的例子中， `hdd_in_order` 策略实现了 [循环制](https://zh.wikipedia.org/wiki/循环制) 方法。因此这个策略只定义了一个卷（`single`），数据片段会以循环的顺序全部存储到它的磁盘上。当有多个类似的磁盘挂载到系统上，但没有配置 RAID 时，这种策略非常有用。请注意一个每个独立的磁盘驱动都并不可靠，你可能需要用 3 或更大的复制因此来补偿它。
+在给出的例子中， `hdd_in_order` 策略实现了 [循环制](https://zh.wikipedia.org/wiki/循环制) 方法。因此这个策略只定义了一个卷（`single`），数据片段会以循环的顺序全部存储到它的磁盘上。当有多个类似的磁盘挂载到系统上，但没有配置 RAID 时，这种策略非常有用。请注意一个每个独立的磁盘驱动都并不可靠，您可能需要用3份或更多的复制份数来补偿它。
 
 如果在系统中有不同类型的磁盘可用，可以使用  `moving_from_ssd_to_hdd`。`hot` 卷由 SSD 磁盘（`fast_ssd`）组成，这个卷上可以存储的数据片段的最大大小为 1GB。所有大于 1GB 的数据片段都会被直接存储到 `cold` 卷上，`cold` 卷包含一个名为 `disk1` 的 HDD 磁盘。
 同样，一旦 `fast_ssd` 被填充超过 80%，数据会通过后台进程向 `disk1` 进行转移。
 
 存储策略中卷的枚举顺序是很重要的。因为当一个卷被充满时，数据会向下一个卷转移。磁盘的枚举顺序同样重要，因为数据是依次存储在磁盘上的。
 
-在创建表时，可以将一个配置好的策略应用到表：
+在创建表时，可以应用存储策略：
 
 ``` sql
 CREATE TABLE table_with_non_default_policy (
@@ -626,7 +684,7 @@ PARTITION BY toYYYYMM(EventDate)
 SETTINGS storage_policy = 'moving_from_ssd_to_hdd'
 ```
 
-`default` 存储策略意味着只使用一个卷，这个卷只包含一个在 `<path>` 中定义的磁盘。表创建后，它的存储策略就不能改变了。
+`default` 存储策略意味着只使用一个卷，这个卷只包含一个在 `<path>` 中定义的磁盘。您可以使用[ALTER TABLE ... MODIFY SETTING]来修改存储策略，新的存储策略应该包含所有以前的磁盘和卷，并使用相同的名称。
 
 可以通过 [background_move_pool_size](../../../operations/settings/settings.md#background_move_pool_size) 设置调整执行后台任务的线程数。
 
@@ -634,24 +692,121 @@ SETTINGS storage_policy = 'moving_from_ssd_to_hdd'
 
 对于 `MergeTree` 表，数据通过以下不同的方式写入到磁盘当中：
 
--   作为插入（`INSERT`查询）的结果
--   在后台合并和[数据变异](../../../sql-reference/statements/alter.md#alter-mutations)期间
--   当从另一个副本下载时
--   作为 [ALTER TABLE … FREEZE PARTITION](../../../sql-reference/statements/alter.md#alter_freeze-partition) 冻结分区的结果
+- 插入（`INSERT`查询）
+- 后台合并和[数据变异](../../../sql-reference/statements/alter.md#alter-mutations)
+- 从另一个副本下载
+- [ALTER TABLE … FREEZE PARTITION](../../../sql-reference/statements/alter.md#alter_freeze-partition) 冻结分区
 
 除了数据变异和冻结分区以外的情况下，数据按照以下逻辑存储到卷或磁盘上：
 
-1.  首个卷（按定义顺序）拥有足够的磁盘空间存储数据片段（`unreserved_space > current_part_size`）并且允许存储给定数据片段的大小（`max_data_part_size_bytes > current_part_size`）
-2.  在这个数据卷内，紧挨着先前存储数据的那块磁盘之后的磁盘，拥有比数据片段大的剩余空间。（`unreserved_space - keep_free_space_bytes > current_part_size`）
+1. 首个卷（按定义顺序）拥有足够的磁盘空间存储数据片段（`unreserved_space > current_part_size`）并且允许存储给定数据片段的大小（`max_data_part_size_bytes > current_part_size`）
+2. 在这个数据卷内，紧挨着先前存储数据的那块磁盘之后的磁盘，拥有比数据片段大的剩余空间。（`unreserved_space - keep_free_space_bytes > current_part_size`）
 
-更进一步，数据变异和分区冻结使用的是 [硬链接](https://en.wikipedia.org/wiki/Hard_link)。不同磁盘之间的硬链接是不支持的，所以在这种情况下数据片段都会被存储到初始化的那一块磁盘上。
+更进一步，数据变异和分区冻结使用的是 [硬链接](https://en.wikipedia.org/wiki/Hard_link)。不同磁盘之间的硬链接是不支持的，所以在这种情况下数据片段都会被存储到原来的那一块磁盘上。
 
-在后台，数据片段基于剩余空间（`move_factor`参数）根据卷在配置文件中定义的顺序进行转移。数据永远不会从最后一个移出也不会从第一个移入。可以通过系统表 [system.part_log](../../../operations/system-tables/part_log.md#system_tables-part-log) (字段 `type = MOVE_PART`) 和 [system.parts](../../../operations/system-tables/parts.md#system_tables-parts) (字段 `path` 和 `disk`) 来监控后台的移动情况。同时，具体细节可以通过服务器日志查看。
+在后台，数据片段基于剩余空间（`move_factor`参数）根据卷在配置文件中定义的顺序进行转移。数据永远不会从最后一个移出也不会从第一个移入。可以通过系统表 [system.part_log](../../../operations/system-tables/part_log.md#system_tables-part-log) (字段 `type = MOVE_PART`) 和 [system.parts](../../../operations/system-tables/parts.md#system_tables-parts) (字段 `path` 和 `disk`) 来监控后台的移动情况。具体细节可以通过服务器日志查看。
 
 用户可以通过 [ALTER TABLE … MOVE PART\|PARTITION … TO VOLUME\|DISK …](../../../sql-reference/statements/alter.md#alter_move-partition) 强制移动一个数据片段或分区到另外一个卷，所有后台移动的限制都会被考虑在内。这个查询会自行启动，无需等待后台操作完成。如果没有足够的可用空间或任何必须条件没有被满足，用户会收到报错信息。
 
 数据移动不会妨碍到数据复制。也就是说，同一张表的不同副本可以指定不同的存储策略。
 
-在后台合并和数据变异之后，就的数据片段会在一定时间后被移除 (`old_parts_lifetime`)。在这期间，他们不能被移动到其他的卷或磁盘。也就是说，直到数据片段被完全移除，它们仍然会被磁盘占用空间计算在内。
+在后台合并和数据变异之后，旧的数据片段会在一定时间后被移除 (`old_parts_lifetime`)。在这期间，他们不能被移动到其他的卷或磁盘。也就是说，直到数据片段被完全移除，它们仍然会被磁盘占用空间计算在内。
+
+## 使用S3进行数据存储 {#using-s3-data-storage}
+
+`MergeTree`系列表引擎允许使用[S3](https://aws.amazon.com/s3/)存储数据，需要修改磁盘类型为`S3`。
+
+示例配置：
+
+``` xml
+<storage_configuration>
+    ...
+    <disks>
+        <s3>
+            <type>s3</type>
+            <endpoint>https://storage.yandexcloud.net/my-bucket/root-path/</endpoint>
+            <access_key_id>your_access_key_id</access_key_id>
+            <secret_access_key>your_secret_access_key</secret_access_key>
+            <region></region>
+            <server_side_encryption_customer_key_base64>your_base64_encoded_customer_key</server_side_encryption_customer_key_base64>
+            <proxy>
+                <uri>http://proxy1</uri>
+                <uri>http://proxy2</uri>
+            </proxy>
+            <connect_timeout_ms>10000</connect_timeout_ms>
+            <request_timeout_ms>5000</request_timeout_ms>
+            <retry_attempts>10</retry_attempts>
+            <single_read_retries>4</single_read_retries>
+            <min_bytes_for_seek>1000</min_bytes_for_seek>
+            <metadata_path>/var/lib/clickhouse/disks/s3/</metadata_path>
+            <cache_enabled>true</cache_enabled>
+            <cache_path>/var/lib/clickhouse/disks/s3/cache/</cache_path>
+            <skip_access_check>false</skip_access_check>
+        </s3>
+    </disks>
+    ...
+</storage_configuration>
+```
+
+必须的参数：
+
+- `endpoint` - S3的结点URL，以`path`或`virtual hosted`[格式](https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html)书写。
+- `access_key_id` - S3的Access Key ID。
+- `secret_access_key` - S3的Secret Access Key。
+
+可选参数：
+
+- `region` - S3的区域名称
+- `use_environment_credentials` - 从环境变量AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY和AWS_SESSION_TOKEN中读取认证参数。默认值为`false`。
+- `use_insecure_imds_request` - 如果设置为`true`，S3客户端在认证时会使用不安全的IMDS请求。默认值为`false`。
+- `proxy` - 访问S3结点URL时代理设置。每一个`uri`项的值都应该是合法的代理URL。
+- `connect_timeout_ms` - Socket连接超时时间，默认值为`10000`，即10秒。
+- `request_timeout_ms` - 请求超时时间，默认值为`5000`，即5秒。
+- `retry_attempts` - 请求失败后的重试次数，默认值为10。
+- `single_read_retries` - 读过程中连接丢失后重试次数，默认值为4。
+- `min_bytes_for_seek` - 使用查找操作，而不是顺序读操作的最小字节数，默认值为1000。
+- `metadata_path` - 本地存放S3元数据文件的路径，默认值为`/var/lib/clickhouse/disks/<disk_name>/`
+- `cache_enabled` - 是否允许缓存标记和索引文件。默认值为`true`。
+- `cache_path` - 本地缓存标记和索引文件的路径。默认值为`/var/lib/clickhouse/disks/<disk_name>/cache/`。
+- `skip_access_check` - 如果为`true`，Clickhouse启动时不检查磁盘是否可用。默认为`false`。
+- `server_side_encryption_customer_key_base64` - 如果指定该项的值，请求时会加上为了访问SSE-C加密数据而必须的头信息。
+
+S3磁盘也可以设置冷热存储：
+```xml
+<storage_configuration>
+    ...
+    <disks>
+        <s3>
+            <type>s3</type>
+            <endpoint>https://storage.yandexcloud.net/my-bucket/root-path/</endpoint>
+            <access_key_id>your_access_key_id</access_key_id>
+            <secret_access_key>your_secret_access_key</secret_access_key>
+        </s3>
+    </disks>
+    <policies>
+        <s3_main>
+            <volumes>
+                <main>
+                    <disk>s3</disk>
+                </main>
+            </volumes>
+        </s3_main>
+        <s3_cold>
+            <volumes>
+                <main>
+                    <disk>default</disk>
+                </main>
+                <external>
+                    <disk>s3</disk>
+                </external>
+            </volumes>
+            <move_factor>0.2</move_factor>
+        </s3_cold>
+    </policies>
+    ...
+</storage_configuration>
+```
+
+指定了`cold`选项后，本地磁盘剩余空间如果小于`move_factor * disk_size`，或有TTL设置时，数据就会定时迁移至S3了。
 
 [原始文章](https://clickhouse.tech/docs/en/operations/table_engines/mergetree/) <!--hide-->

docs/zh/operations/system-tables/asynchronous_metric_log.md

@@ -3,6 +3,6 @@ machine_translated: true
 machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
 ---
 
-## 系统。asynchronous_metric_log {#system-tables-async-log}
+## system.asynchronous_metric_log {#system-tables-async-log}
 
 包含以下内容的历史值 `system.asynchronous_log` （见 [系统。asynchronous_metrics](../../operations/system-tables/asynchronous_metrics.md#system_tables-asynchronous_metrics))

docs/zh/operations/system-tables/asynchronous_metrics.md

@@ -3,14 +3,14 @@ machine_translated: true
 machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
 ---
 
-# 系统。asynchronous_metrics {#system_tables-asynchronous_metrics}
+# system.asynchronous_metrics {#system_tables-asynchronous_metrics}
 
 包含在后台定期计算的指标。 例如，在使用的RAM量。
 
 列:
 
--   `metric` ([字符串](../../sql-reference/data-types/string.md)) — Metric name.
--   `value` ([Float64](../../sql-reference/data-types/float.md)) — Metric value.
+-   `metric` ([字符串](../../sql-reference/data-types/string.md)) — 指标名。 
+-   `value` ([Float64](../../sql-reference/data-types/float.md)) — 指标值。 
 
 **示例**
 
@@ -34,8 +34,7 @@ SELECT * FROM system.asynchronous_metrics LIMIT 10
 ```
 
 **另请参阅**
-
--   [监测](../../operations/monitoring.md) — Base concepts of ClickHouse monitoring.
--   [系统。指标](../../operations/system-tables/metrics.md#system_tables-metrics) — Contains instantly calculated metrics.
--   [系统。活动](../../operations/system-tables/events.md#system_tables-events) — Contains a number of events that have occurred.
--   [系统。metric_log](../../operations/system-tables/metric_log.md#system_tables-metric_log) — Contains a history of metrics values from tables `system.metrics` и `system.events`.
+-   [监测](../../operations/monitoring.md) — ClickHouse监控的基本概念。
+-   [系统。指标](../../operations/system-tables/metrics.md#system_tables-metrics) — 包含即时计算的指标。 
+-   [系统。活动](../../operations/system-tables/events.md#system_tables-events) — 包含出现的事件的次数。 
+-   [系统。metric\_log](../../operations/system-tables/metric_log.md#system_tables-metric_log) — 包含`system.metrics` 和 `system.events`表中的指标的历史值。

docs/zh/operations/system-tables/clusters.md

@@ -1,24 +1,20 @@
----
-machine_translated: true
-machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
----
-
-# 系统。集群 {#system-clusters}
+# system.clusters{#system-clusters}
 
 包含有关配置文件中可用的集群及其中的服务器的信息。
 
 列:
 
--   `cluster` (String) — The cluster name.
--   `shard_num` (UInt32) — The shard number in the cluster, starting from 1.
--   `shard_weight` (UInt32) — The relative weight of the shard when writing data.
--   `replica_num` (UInt32) — The replica number in the shard, starting from 1.
--   `host_name` (String) — The host name, as specified in the config.
--   `host_address` (String) — The host IP address obtained from DNS.
--   `port` (UInt16) — The port to use for connecting to the server.
--   `user` (String) — The name of the user for connecting to the server.
--   `errors_count` (UInt32)-此主机无法到达副本的次数。
--   `estimated_recovery_time` (UInt32)-剩下的秒数，直到副本错误计数归零，它被认为是恢复正常。
+-   `cluster` (String) — 集群名。
+-   `shard_num` (UInt32) — 集群中的分片数，从1开始。 
+-   `shard_weight` (UInt32) — 写数据时该分片的相对权重。
+-   `replica_num` (UInt32) — 分片的副本数量，从1开始。 
+-   `host_name` (String) — 配置中指定的主机名。 
+-   `host_address` (String) — 从DNS获取的主机IP地址。
+-   `port` (UInt16) — 连接到服务器的端口。 
+-   `user` (String) — 连接到服务器的用户名。 
+-   `errors_count` (UInt32) - 此主机无法访问副本的次数。
+-   `slowdowns_count` (UInt32) - 与对冲请求建立连接时导致更改副本的减速次数。
+-   `estimated_recovery_time` (UInt32) - 剩下的秒数，直到副本错误计数归零并被视为恢复正常。
 
 请注意 `errors_count` 每个查询集群更新一次，但 `estimated_recovery_time` 按需重新计算。 所以有可能是非零的情况 `errors_count` 和零 `estimated_recovery_time`，下一个查询将为零 `errors_count` 并尝试使用副本，就好像它没有错误。
 
@@ -27,3 +23,5 @@ machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
 -   [表引擎分布式](../../engines/table-engines/special/distributed.md)
 -   [distributed_replica_error_cap设置](../../operations/settings/settings.md#settings-distributed_replica_error_cap)
 -   [distributed_replica_error_half_life设置](../../operations/settings/settings.md#settings-distributed_replica_error_half_life)
+
+[原文](https://clickhouse.tech/docs/zh/operations/system-tables/clusters) <!--hide-->

docs/zh/operations/system-tables/columns.md

@@ -25,3 +25,5 @@ machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
 -   `is_in_sorting_key` (UInt8) — Flag that indicates whether the column is in the sorting key expression.
 -   `is_in_primary_key` (UInt8) — Flag that indicates whether the column is in the primary key expression.
 -   `is_in_sampling_key` (UInt8) — Flag that indicates whether the column is in the sampling key expression.
+
+[原文](https://clickhouse.tech/docs/zh/operations/system-tables/columns) <!--hide-->

docs/zh/operations/system-tables/tables.md

@@ -5,15 +5,15 @@ machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
 
 # 系统。表 {#system-tables}
 
-包含服务器知道的每个表的元数据。 分离的表不显示在 `system.tables`.
+包含服务器知道的每个表的元数据。 分离的表不显示在 `system.tables`。
 
 此表包含以下列（列类型显示在括号中):
 
--   `database` (String) — The name of the database the table is in.
+-   `database` (String) — 表所在的数据库表名。
 
--   `name` (String) — Table name.
+-   `name` (String) — 表名。
 
--   `engine` (String) — Table engine name (without parameters).
+-   `engine` (String) — 表引擎名 (不包含参数)。
 
 -   `is_temporary` (UInt8)-指示表是否是临时的标志。
 
@@ -23,11 +23,11 @@ machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
 
 -   `metadata_modification_time` (DateTime)-表元数据的最新修改时间。
 
--   `dependencies_database` (数组(字符串))-数据库依赖关系.
+-   `dependencies_database` (数组(字符串))-数据库依赖关系。
 
 -   `dependencies_table` （数组（字符串））-表依赖关系 ([MaterializedView](../../engines/table-engines/special/materializedview.md) 基于当前表的表）。
 
--   `create_table_query` (String)-用于创建表的查询。
+-   `create_table_query` (String)-用于创建表的SQL语句。
 
 -   `engine_full` (String)-表引擎的参数。
 
@@ -44,11 +44,15 @@ machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
     -   [MergeTree](../../engines/table-engines/mergetree-family/mergetree.md#table_engine-mergetree-multiple-volumes)
     -   [分布](../../engines/table-engines/special/distributed.md#distributed)
 
--   `total_rows` (Nullable(UInt64))-总行数，如果可以快速确定表中的确切行数，否则 `Null` （包括内衣 `Buffer` 表）。
+-   `total_rows` (Nullable(UInt64))-总行数，如果可以快速确定表中的确切行数，否则行数为`Null`（包括底层 `Buffer` 表）。
 
--   `total_bytes` (Nullable(UInt64))-总字节数，如果可以快速确定存储表的确切字节数，否则 `Null` (**不** 包括任何底层存储）。
+-   `total_bytes` (Nullable(UInt64))-总字节数，如果可以快速确定存储表的确切字节数，否则字节数为`Null` (即**不** 包括任何底层存储）。
 
-    -   If the table stores data on disk, returns used space on disk (i.e. compressed).
-    -   如果表在内存中存储数据,返回在内存中使用的近似字节数.
+    -   如果表将数据存在磁盘上，返回实际使用的磁盘空间（压缩后）。
+    -   如果表在内存中存储数据，返回在内存中使用的近似字节数。
 
-该 `system.tables` 表中使用 `SHOW TABLES` 查询实现。
+-   `lifetime_rows` (Nullbale(UInt64))-服务启动后插入的总行数(只针对`Buffer`表）。 
+
+`system.tables` 表被用于 `SHOW TABLES` 的查询实现中。
+
+[原文](https://clickhouse.tech/docs/zh/operations/system-tables/tables) <!--hide-->

docs/zh/operations/system-tables/zookeeper.md

@@ -3,13 +3,13 @@ machine_translated: true
 machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
 ---
 
-# 系统。动物园管理员 {#system-zookeeper}
+# system.zookeeper {#system-zookeeper}
 
-如果未配置ZooKeeper，则表不存在。 允许从配置中定义的ZooKeeper集群读取数据。
-查询必须具有 ‘path’ WHERE子句中的相等条件或者在某个集合中的条件。 这是ZooKeeper中您想要获取数据的孩子的路径。
+如果未配置ZooKeeper，则该表不存在。 允许从配置中定义的ZooKeeper集群读取数据。
+查询必须具有 ‘path’ WHERE子句中的相等条件。 这是ZooKeeper中您想要获取数据的子路径。
 
-查询 `SELECT * FROM system.zookeeper WHERE path = '/clickhouse'` 输出对所有孩子的数据 `/clickhouse` 节点。
-要输出所有根节点的数据，write path= ‘/’.
+查询 `SELECT * FROM system.zookeeper WHERE path = '/clickhouse'` 输出`/clickhouse`节点的对所有子路径的数据。
+要输出所有根节点的数据，使用path= ‘/’.
 如果在指定的路径 ‘path’ 不存在，将引发异常。
 
 查询`SELECT * FROM system.zookeeper WHERE path IN ('/', '/clickhouse')` 输出`/` 和 `/clickhouse`节点上所有子节点的数据。
@@ -18,20 +18,20 @@ machine_translated_rev: 5decc73b5dc60054f19087d3690c4eb99446a6c3
 
 列:
 
--   `name` (String) — The name of the node.
--   `path` (String) — The path to the node.
--   `value` (String) — Node value.
--   `dataLength` (Int32) — Size of the value.
--   `numChildren` (Int32) — Number of descendants.
--   `czxid` (Int64) — ID of the transaction that created the node.
--   `mzxid` (Int64) — ID of the transaction that last changed the node.
--   `pzxid` (Int64) — ID of the transaction that last deleted or added descendants.
--   `ctime` (DateTime) — Time of node creation.
--   `mtime` (DateTime) — Time of the last modification of the node.
--   `version` (Int32) — Node version: the number of times the node was changed.
--   `cversion` (Int32) — Number of added or removed descendants.
--   `aversion` (Int32) — Number of changes to the ACL.
--   `ephemeralOwner` (Int64) — For ephemeral nodes, the ID of the session that owns this node.
+-   `name` (String) — 节点的名字。
+-   `path` (String) — 节点的路径。
+-   `value` (String) — 节点的值。 
+-   `dataLength` (Int32) — 节点的值长度。
+-   `numChildren` (Int32) — 子节点的个数。
+-   `czxid` (Int64) — 创建该节点的事务ID。
+-   `mzxid` (Int64) — 最后修改该节点的事务ID。
+-   `pzxid` (Int64) — 最后删除或者增加子节点的事务ID。
+-   `ctime` (DateTime) — 节点的创建时间。 
+-   `mtime` (DateTime) — 节点的最后修改时间。 
+-   `version` (Int32) — 节点版本：节点被修改的次数。
+-   `cversion` (Int32) — 增加或删除子节点的个数。
+-   `aversion` (Int32) — ACL的修改次数。
+-   `ephemeralOwner` (Int64) — 针对临时节点，拥有该节点的事务ID。
 
 示例:
 
@@ -77,3 +77,4 @@ numChildren:    7
 pzxid:          987021252247
 path:           /clickhouse/tables/01-08/visits/replicas
 ```
+[原文](https://clickhouse.tech/docs/zh/operations/system-tables/zookeeper) <!--hide-->

programs/benchmark/Benchmark.cpp

@@ -37,6 +37,7 @@
 #include <Common/StudentTTest.h>
 #include <filesystem>
 
+
 namespace fs = std::filesystem;
 
 /** A tool for evaluating ClickHouse performance.

src/Functions/array/mapOp.cpp

@@ -1,20 +1,25 @@
 #include <cassert>
-#include <Columns/ColumnVector.h>
+#include <Columns/ColumnFixedString.h>
+#include <Columns/ColumnString.h>
 #include <Columns/ColumnTuple.h>
+#include <Columns/ColumnVector.h>
+#include <Columns/IColumn.h>
+#include <Core/ColumnWithTypeAndName.h>
 #include <DataTypes/DataTypeArray.h>
 #include <DataTypes/DataTypeTuple.h>
 #include <DataTypes/DataTypesNumber.h>
 #include <Functions/FunctionFactory.h>
 #include <Functions/FunctionHelpers.h>
 #include <common/arithmeticOverflow.h>
-#include <Core/ColumnWithTypeAndName.h>
+#include "Columns/ColumnMap.h"
+#include "DataTypes/DataTypeMap.h"
 
 
 namespace DB
 {
 namespace ErrorCodes
 {
-    extern const int ILLEGAL_COLUMN;
+    extern const int LOGICAL_ERROR;
     extern const int ILLEGAL_TYPE_OF_ARGUMENT;
     extern const int NUMBER_OF_ARGUMENTS_DOESNT_MATCH;
 }
@@ -24,8 +29,8 @@ namespace
 
 struct TupArg
 {
-    const IColumn & key_column;
-    const IColumn & val_column;
+    const ColumnPtr & key_column;
+    const ColumnPtr & val_column;
     const IColumn::Offsets & key_offsets;
     const IColumn::Offsets & val_offsets;
     bool is_const;
@@ -52,27 +57,49 @@ private:
     bool isVariadic() const override { return true; }
     bool useDefaultImplementationForConstants() const override { return true; }
 
-    DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override
+    void checkTypes(
+        DataTypePtr & key_type, DataTypePtr & promoted_val_type, const DataTypePtr & check_key_type, DataTypePtr & check_val_type) const
+    {
+        if (!(check_key_type->equals(*key_type)))
+            throw Exception(
+                "Expected same " + key_type->getName() + " type for all keys in " + getName(), ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
+
+        WhichDataType which_val(promoted_val_type);
+        WhichDataType which_ch_val(check_val_type);
+
+        if (which_ch_val.isFloat() != which_val.isFloat())
+            throw Exception(
+                "All value types in " + getName() + " should be either or float or integer", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
+
+        if (!(check_val_type->equals(*promoted_val_type)))
+        {
+            throw Exception(
+                "All value types in " + getName() + " should be promotable to " + promoted_val_type->getName() + ", got "
+                    + check_val_type->getName(),
+                ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
+        }
+    }
+
+    DataTypePtr getReturnTypeForTuples(const DataTypes & arguments) const
     {
-        bool is_float = false;
         DataTypePtr key_type, val_type, res;
 
-        if (arguments.size() < 2)
-            throw Exception{getName() + " accepts at least two map tuples", ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH};
-
-        for (const auto & tup_arg : arguments)
+        for (const auto & arg : arguments)
         {
-            const DataTypeTuple * tup = checkAndGetDataType<DataTypeTuple>(tup_arg.get());
+            const DataTypeArray * k;
+            const DataTypeArray * v;
+
+            const DataTypeTuple * tup = checkAndGetDataType<DataTypeTuple>(arg.get());
             if (!tup)
-                throw Exception{getName() + " accepts at least two map tuples", ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH};
+                throw Exception(getName() + " accepts at least two map tuples", ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH);
 
             auto elems = tup->getElements();
             if (elems.size() != 2)
                 throw Exception(
                     "Each tuple in " + getName() + " arguments should consist of two arrays", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
 
-            const DataTypeArray * k = checkAndGetDataType<DataTypeArray>(elems[0].get());
-            const DataTypeArray * v = checkAndGetDataType<DataTypeArray>(elems[1].get());
+            k = checkAndGetDataType<DataTypeArray>(elems[0].get());
+            v = checkAndGetDataType<DataTypeArray>(elems[1].get());
 
             if (!k || !v)
                 throw Exception(
@@ -80,62 +107,100 @@ private:
 
             auto result_type = v->getNestedType();
             if (!result_type->canBePromoted())
-                throw Exception{"Values to be summed are expected to be Numeric, Float or Decimal.",
-                                ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT};
+                throw Exception(
+                    "Values to be summed are expected to be Numeric, Float or Decimal.", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
 
-            WhichDataType which_val(result_type);
-
-            auto promoted_type = result_type->promoteNumericType();
+            auto promoted_val_type = result_type->promoteNumericType();
             if (!key_type)
             {
                 key_type = k->getNestedType();
-                val_type = promoted_type;
-                is_float = which_val.isFloat();
+                val_type = promoted_val_type;
+                res = std::make_shared<DataTypeTuple>(
+                    DataTypes{std::make_shared<DataTypeArray>(k->getNestedType()), std::make_shared<DataTypeArray>(promoted_val_type)});
             }
             else
-            {
-                if (!(k->getNestedType()->equals(*key_type)))
-                    throw Exception(
-                        "All key types in " + getName() + " should be same: " + key_type->getName(),
-                        ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
-
-                if (is_float != which_val.isFloat())
-                    throw Exception(
-                        "All value types in " + getName() + " should be or float or integer", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
-
-                if (!(promoted_type->equals(*val_type)))
-                {
-                    throw Exception(
-                        "All value types in " + getName() + " should be promotable to " + val_type->getName() + ", got "
-                            + promoted_type->getName(),
-                        ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
-                }
-            }
-
-            if (!res)
-            {
-                res = std::make_shared<DataTypeTuple>(
-                    DataTypes{std::make_shared<DataTypeArray>(k->getNestedType()), std::make_shared<DataTypeArray>(promoted_type)});
-            }
+                checkTypes(key_type, val_type, k->getNestedType(), promoted_val_type);
         }
 
         return res;
     }
 
-    template <typename KeyType, bool is_str_key, typename ValType>
-    ColumnPtr execute2(size_t row_count, TupleMaps & args, const DataTypeTuple & res_type) const
+    DataTypePtr getReturnTypeForMaps(const DataTypes & arguments) const
     {
-        MutableColumnPtr res_tuple = res_type.createColumn();
+        DataTypePtr key_type, val_type, res;
 
-        auto * to_tuple = assert_cast<ColumnTuple *>(res_tuple.get());
-        auto & to_keys_arr = assert_cast<ColumnArray &>(to_tuple->getColumn(0));
-        auto & to_keys_data = to_keys_arr.getData();
-        auto & to_keys_offset = to_keys_arr.getOffsets();
+        for (const auto & arg : arguments)
+        {
+            const auto * map = checkAndGetDataType<DataTypeMap>(arg.get());
+            if (!map)
+                throw Exception(getName() + " accepts at least two maps", ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH);
 
-        auto & to_vals_arr = assert_cast<ColumnArray &>(to_tuple->getColumn(1));
-        auto & to_vals_data = to_vals_arr.getData();
+            const auto & v = map->getValueType();
+
+            if (!v->canBePromoted())
+                throw Exception(
+                    "Values to be summed are expected to be Numeric, Float or Decimal.", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
+
+            auto promoted_val_type = v->promoteNumericType();
+            if (!key_type)
+            {
+                key_type = map->getKeyType();
+                val_type = promoted_val_type;
+                res = std::make_shared<DataTypeMap>(DataTypes({key_type, promoted_val_type}));
+            }
+            else
+                checkTypes(key_type, val_type, map->getKeyType(), promoted_val_type);
+        }
+
+        return res;
+    }
+
+    DataTypePtr getReturnTypeImpl(const DataTypes & arguments) const override
+    {
+        if (arguments.size() < 2)
+            throw Exception(getName() + " accepts at least two maps or map tuples", ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH);
+
+        if (arguments[0]->getTypeId() == TypeIndex::Tuple)
+            return getReturnTypeForTuples(arguments);
+        else if (arguments[0]->getTypeId() == TypeIndex::Map)
+            return getReturnTypeForMaps(arguments);
+        else
+            throw Exception(getName() + " only accepts maps", ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
+    }
+
+    template <typename KeyType, typename ValType>
+    ColumnPtr execute2(size_t row_count, TupleMaps & args, const DataTypePtr res_type) const
+    {
+        MutableColumnPtr res_column = res_type->createColumn();
+        IColumn *to_keys_data, *to_vals_data;
+        ColumnArray::Offsets * to_keys_offset;
+        ColumnArray::Offsets * to_vals_offset = nullptr;
+
+        // prepare output destinations
+        if (res_type->getTypeId() == TypeIndex::Tuple)
+        {
+            auto * to_tuple = assert_cast<ColumnTuple *>(res_column.get());
+            auto & to_keys_arr = assert_cast<ColumnArray &>(to_tuple->getColumn(0));
+            to_keys_data = &to_keys_arr.getData();
+            to_keys_offset = &to_keys_arr.getOffsets();
+
+            auto & to_vals_arr = assert_cast<ColumnArray &>(to_tuple->getColumn(1));
+            to_vals_data = &to_vals_arr.getData();
+            to_vals_offset = &to_vals_arr.getOffsets();
+        }
+        else
+        {
+            assert(res_type->getTypeId() == TypeIndex::Map);
+
+            auto * to_map = assert_cast<ColumnMap *>(res_column.get());
+            auto & to_wrapper_arr = to_map->getNestedColumn();
+            to_keys_offset = &to_wrapper_arr.getOffsets();
+
+            auto & to_map_tuple = to_map->getNestedData();
+            to_keys_data = &to_map_tuple.getColumn(0);
+            to_vals_data = &to_map_tuple.getColumn(1);
+        }
 
-        size_t res_offset = 0;
         std::map<KeyType, ValType> summing_map;
 
         for (size_t i = 0; i < row_count; i++)
@@ -147,7 +212,7 @@ private:
 
                 if (!arg.is_const)
                 {
-                    offset = i > 0 ? arg.key_offsets[i - 1] : 0;
+                    offset = arg.key_offsets[i - 1];
                     len = arg.key_offsets[i] - offset;
 
                     if (arg.val_offsets[i] != arg.key_offsets[i])
@@ -155,20 +220,30 @@ private:
                             "Key and value array should have same amount of elements", ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH);
                 }
 
+                Field temp_val;
                 for (size_t j = 0; j < len; j++)
                 {
                     KeyType key;
-                    if constexpr (is_str_key)
+                    if constexpr (std::is_same<KeyType, String>::value)
                     {
-                        // have to use Field to get strings
-                        key = arg.key_column[offset + j].get<KeyType>();
+                        if (const auto * col_fixed = checkAndGetColumn<ColumnFixedString>(arg.key_column.get()))
+                            key = col_fixed->getDataAt(offset + j).toString();
+                        else if (const auto * col_str = checkAndGetColumn<ColumnString>(arg.key_column.get()))
+                            key = col_str->getDataAt(offset + j).toString();
+                        else
+                            // should not happen
+                            throw Exception(
+                                "Expected String or FixedString, got " + std::string(getTypeName(arg.key_column->getDataType()))
+                                    + " in " + getName(),
+                                ErrorCodes::LOGICAL_ERROR);
                     }
                     else
                     {
-                        key = assert_cast<const ColumnVector<KeyType> &>(arg.key_column).getData()[offset + j];
+                        key = assert_cast<const ColumnVector<KeyType> *>(arg.key_column.get())->getData()[offset + j];
                     }
 
-                    ValType value = arg.val_column[offset + j].get<ValType>();
+                    arg.val_column->get(offset + j, temp_val);
+                    ValType value = temp_val.get<ValType>();
 
                     if constexpr (op_type == OpTypes::ADD)
                     {
@@ -190,132 +265,184 @@ private:
 
             for (const auto & elem : summing_map)
             {
-                res_offset++;
-                to_keys_data.insert(elem.first);
-                to_vals_data.insert(elem.second);
+                to_keys_data->insert(elem.first);
+                to_vals_data->insert(elem.second);
             }
-            to_keys_offset.push_back(res_offset);
+            to_keys_offset->push_back(to_keys_data->size());
             summing_map.clear();
         }
 
-        // same offsets as in keys
-        to_vals_arr.getOffsets().insert(to_keys_offset.begin(), to_keys_offset.end());
+        if (to_vals_offset)
+        {
+            // same offsets as in keys
+            to_vals_offset->insert(to_keys_offset->begin(), to_keys_offset->end());
+        }
 
-        return res_tuple;
+        return res_column;
     }
 
-    template <typename KeyType, bool is_str_key>
-    ColumnPtr execute1(size_t row_count, const DataTypeTuple & res_type, TupleMaps & args) const
+    template <typename KeyType>
+    ColumnPtr execute1(size_t row_count, const DataTypePtr res_type, const DataTypePtr res_value_type, TupleMaps & args) const
     {
-        const auto & promoted_type = (assert_cast<const DataTypeArray *>(res_type.getElements()[1].get()))->getNestedType();
-#define MATCH_EXECUTE(is_str) \
-        switch (promoted_type->getTypeId()) \
-        { \
-            case TypeIndex::Int64: return execute2<KeyType, is_str, Int64>(row_count, args, res_type); \
-            case TypeIndex::UInt64: return execute2<KeyType, is_str, UInt64>(row_count, args, res_type); \
-            case TypeIndex::Float64: return execute2<KeyType, is_str, Float64>(row_count, args, res_type); \
-            default: \
-                throw Exception{"Illegal columns in arguments of function " + getName(), ErrorCodes::ILLEGAL_COLUMN}; \
-        }
-
-        if constexpr (is_str_key)
+        switch (res_value_type->getTypeId())
         {
-            MATCH_EXECUTE(true)
+            case TypeIndex::Int64:
+                return execute2<KeyType, Int64>(row_count, args, res_type);
+            case TypeIndex::Int128:
+                return execute2<KeyType, Int128>(row_count, args, res_type);
+            case TypeIndex::Int256:
+                return execute2<KeyType, Int256>(row_count, args, res_type);
+            case TypeIndex::UInt64:
+                return execute2<KeyType, UInt64>(row_count, args, res_type);
+            case TypeIndex::UInt128:
+                return execute2<KeyType, UInt128>(row_count, args, res_type);
+            case TypeIndex::UInt256:
+                return execute2<KeyType, UInt256>(row_count, args, res_type);
+            case TypeIndex::Float64:
+                return execute2<KeyType, Float64>(row_count, args, res_type);
+            default:
+                throw Exception(
+                    "Illegal column type " + res_value_type->getName() + " for values in arguments of function " + getName(),
+                    ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
         }
-        else
-        {
-            MATCH_EXECUTE(false)
-        }
-#undef MATCH_EXECUTE
     }
 
     ColumnPtr executeImpl(const ColumnsWithTypeAndName & arguments, const DataTypePtr &, size_t) const override
     {
+        DataTypePtr key_type;
+        size_t row_count;
         const DataTypeTuple * tup_type = checkAndGetDataType<DataTypeTuple>((arguments[0]).type.get());
-        const DataTypeArray * key_array_type = checkAndGetDataType<DataTypeArray>(tup_type->getElements()[0].get());
-        const DataTypeArray * val_array_type = checkAndGetDataType<DataTypeArray>(tup_type->getElements()[1].get());
-
-        /* determine output type */
-        const DataTypeTuple & res_type
-            = DataTypeTuple(DataTypes{std::make_shared<DataTypeArray>(key_array_type->getNestedType()),
-                                      std::make_shared<DataTypeArray>(val_array_type->getNestedType()->promoteNumericType())});
-
+        DataTypePtr res_type;
+        DataTypePtr res_value_type;
         TupleMaps args{};
         args.reserve(arguments.size());
 
         //prepare columns, extract data columns for direct access and put them to the vector
-        for (const auto & col : arguments)
+        if (tup_type)
         {
-            const ColumnTuple * tup;
-            bool is_const = isColumnConst(*col.column);
-            if (is_const)
+            const DataTypeArray * key_array_type = checkAndGetDataType<DataTypeArray>(tup_type->getElements()[0].get());
+            const DataTypeArray * val_array_type = checkAndGetDataType<DataTypeArray>(tup_type->getElements()[1].get());
+
+            /* determine output type */
+            res_value_type = val_array_type->getNestedType()->promoteNumericType();
+            res_type = std::make_shared<DataTypeTuple>(DataTypes{
+                std::make_shared<DataTypeArray>(key_array_type->getNestedType()), std::make_shared<DataTypeArray>(res_value_type)});
+
+            for (const auto & col : arguments)
             {
-                const auto * c = assert_cast<const ColumnConst *>(col.column.get());
-                tup = assert_cast<const ColumnTuple *>(c->getDataColumnPtr().get());
+                const ColumnTuple * tup;
+                bool is_const = isColumnConst(*col.column);
+                if (is_const)
+                {
+                    const auto * c = assert_cast<const ColumnConst *>(col.column.get());
+                    tup = assert_cast<const ColumnTuple *>(c->getDataColumnPtr().get());
+                }
+                else
+                    tup = assert_cast<const ColumnTuple *>(col.column.get());
+
+                const auto & arr1 = assert_cast<const ColumnArray &>(tup->getColumn(0));
+                const auto & arr2 = assert_cast<const ColumnArray &>(tup->getColumn(1));
+
+                const auto & key_offsets = arr1.getOffsets();
+                const auto & key_column = arr1.getDataPtr();
+
+                const auto & val_offsets = arr2.getOffsets();
+                const auto & val_column = arr2.getDataPtr();
+
+                args.push_back({key_column, val_column, key_offsets, val_offsets, is_const});
+            }
+
+            key_type = key_array_type->getNestedType();
+        }
+        else
+        {
+            const DataTypeMap * map_type = checkAndGetDataType<DataTypeMap>((arguments[0]).type.get());
+            if (map_type)
+            {
+                key_type = map_type->getKeyType();
+                res_value_type = map_type->getValueType()->promoteNumericType();
+                res_type = std::make_shared<DataTypeMap>(DataTypes{map_type->getKeyType(), res_value_type});
+
+                for (const auto & col : arguments)
+                {
+                    const ColumnMap * map;
+                    bool is_const = isColumnConst(*col.column);
+                    if (is_const)
+                    {
+                        const auto * c = assert_cast<const ColumnConst *>(col.column.get());
+                        map = assert_cast<const ColumnMap *>(c->getDataColumnPtr().get());
+                    }
+                    else
+                        map = assert_cast<const ColumnMap *>(col.column.get());
+
+                    const auto & map_arr = map->getNestedColumn();
+                    const auto & key_offsets = map_arr.getOffsets();
+                    const auto & val_offsets = key_offsets;
+
+                    const auto & map_tup = map->getNestedData();
+                    const auto & key_column = map_tup.getColumnPtr(0);
+                    const auto & val_column = map_tup.getColumnPtr(1);
+
+                    args.push_back({key_column, val_column, key_offsets, val_offsets, is_const});
+                }
             }
             else
-                tup = assert_cast<const ColumnTuple *>(col.column.get());
+                throw Exception(
+                    "Illegal column type " + arguments[0].type->getName() + " in arguments of function " + getName(),
+                    ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
+        }
 
-            const auto & arr1 = assert_cast<const ColumnArray &>(tup->getColumn(0));
-            const auto & arr2 = assert_cast<const ColumnArray &>(tup->getColumn(1));
-
-            const auto & key_offsets = arr1.getOffsets();
-            const auto & key_column = arr1.getData();
-
-            const auto & val_offsets = arr2.getOffsets();
-            const auto & val_column = arr2.getData();
-
-            // we can check const columns before any processing
-            if (is_const)
+        // we can check const columns before any processing
+        for (auto & arg : args)
+        {
+            if (arg.is_const)
             {
-                if (val_offsets[0] != key_offsets[0])
+                if (arg.val_offsets[0] != arg.key_offsets[0])
                     throw Exception(
                         "Key and value array should have same amount of elements", ErrorCodes::NUMBER_OF_ARGUMENTS_DOESNT_MATCH);
             }
-
-            args.push_back({key_column, val_column, key_offsets, val_offsets, is_const});
         }
 
-        size_t row_count = arguments[0].column->size();
-        auto key_type_id = key_array_type->getNestedType()->getTypeId();
-
-        switch (key_type_id)
+        row_count = arguments[0].column->size();
+        switch (key_type->getTypeId())
         {
             case TypeIndex::Enum8:
             case TypeIndex::Int8:
-                return execute1<Int8, false>(row_count, res_type, args);
+                return execute1<Int8>(row_count, res_type, res_value_type, args);
             case TypeIndex::Enum16:
             case TypeIndex::Int16:
-                return execute1<Int16, false>(row_count, res_type, args);
+                return execute1<Int16>(row_count, res_type, res_value_type, args);
             case TypeIndex::Int32:
-                return execute1<Int32, false>(row_count, res_type, args);
+                return execute1<Int32>(row_count, res_type, res_value_type, args);
             case TypeIndex::Int64:
-                return execute1<Int64, false>(row_count, res_type, args);
+                return execute1<Int64>(row_count, res_type, res_value_type, args);
             case TypeIndex::Int128:
-                return execute1<Int128, false>(row_count, res_type, args);
+                return execute1<Int128>(row_count, res_type, res_value_type, args);
             case TypeIndex::Int256:
-                return execute1<Int256, false>(row_count, res_type, args);
+                return execute1<Int256>(row_count, res_type, res_value_type, args);
             case TypeIndex::UInt8:
-                return execute1<UInt8, false>(row_count, res_type, args);
+                return execute1<UInt8>(row_count, res_type, res_value_type, args);
             case TypeIndex::Date:
             case TypeIndex::UInt16:
-                return execute1<UInt16, false>(row_count, res_type, args);
+                return execute1<UInt16>(row_count, res_type, res_value_type, args);
             case TypeIndex::DateTime:
             case TypeIndex::UInt32:
-                return execute1<UInt32, false>(row_count, res_type, args);
+                return execute1<UInt32>(row_count, res_type, res_value_type, args);
             case TypeIndex::UInt64:
-                return execute1<UInt64, false>(row_count, res_type, args);
+                return execute1<UInt64>(row_count, res_type, res_value_type, args);
             case TypeIndex::UInt128:
-                return execute1<UInt128, false>(row_count, res_type, args);
+                return execute1<UInt128>(row_count, res_type, res_value_type, args);
             case TypeIndex::UInt256:
-                return execute1<UInt256, false>(row_count, res_type, args);
+                return execute1<UInt256>(row_count, res_type, res_value_type, args);
             case TypeIndex::UUID:
-                return execute1<UUID, false>(row_count, res_type, args);
+                return execute1<UUID>(row_count, res_type, res_value_type, args);
             case TypeIndex::FixedString:
             case TypeIndex::String:
-                return execute1<String, true>(row_count, res_type, args);
+                return execute1<String>(row_count, res_type, res_value_type, args);
             default:
-                throw Exception{"Illegal columns in arguments of function " + getName(), ErrorCodes::ILLEGAL_COLUMN};
+                throw Exception(
+                    "Illegal column type " + key_type->getName() + " for keys in arguments of function " + getName(),
+                    ErrorCodes::ILLEGAL_TYPE_OF_ARGUMENT);
         }
     }
 };

tests/integration/helpers/network.py

@@ -127,21 +127,21 @@ class _NetworkManager:
         return cls._instance
 
     def add_iptables_rule(self, **kwargs):
-        cmd = ['iptables', '-I', 'DOCKER-USER', '1']
+        cmd = ['iptables', '--wait', '-I', 'DOCKER-USER', '1']
         cmd.extend(self._iptables_cmd_suffix(**kwargs))
-        self._exec_run_with_retry(cmd, retry_count=3, privileged=True)
+        self._exec_run(cmd, privileged=True)
 
     def delete_iptables_rule(self, **kwargs):
-        cmd = ['iptables', '-D', 'DOCKER-USER']
+        cmd = ['iptables', '--wait', '-D', 'DOCKER-USER']
         cmd.extend(self._iptables_cmd_suffix(**kwargs))
-        self._exec_run_with_retry(cmd, retry_count=3, privileged=True)
+        self._exec_run(cmd, privileged=True)
 
     @staticmethod
     def clean_all_user_iptables_rules():
         for i in range(1000):
             iptables_iter = i
             # when rules will be empty, it will return error
-            res = subprocess.run("iptables -D DOCKER-USER 1", shell=True)
+            res = subprocess.run("iptables --wait -D DOCKER-USER 1", shell=True)
 
             if res.returncode != 0:
                 logging.info("All iptables rules cleared, " + str(iptables_iter) + " iterations, last error: " + str(res.stderr))

tests/queries/0_stateless/01318_map_add_map_subtract.sql

@@ -2,7 +2,7 @@ drop table if exists map_test;
 create table map_test engine=TinyLog() as (select ([1, number], [toInt32(2),2]) as map from numbers(1, 10));
 
 -- mapAdd
-select mapAdd([1], [1]); -- { serverError 42 }
+select mapAdd([1], [1]); -- { serverError 43 }
 select mapAdd(([1], [1])); -- { serverError 42 }
 select mapAdd(([1], [1]), map) from map_test; -- { serverError 43 }
 select mapAdd(([toUInt64(1)], [1]), map) from map_test; -- { serverError 43 }
@@ -27,7 +27,7 @@ select mapAdd(([toInt64(1), 2], [toInt64(1), 1]), ([toInt64(1), 2], [toInt64(1),
 
 select mapAdd(([1, 2], [toFloat32(1.1), 1]), ([1, 2], [2.2, 1])) as res, toTypeName(res);
 select mapAdd(([1, 2], [toFloat64(1.1), 1]), ([1, 2], [2.2, 1])) as res, toTypeName(res);
-select mapAdd(([toFloat32(1), 2], [toFloat64(1.1), 1]), ([toFloat32(1), 2], [2.2, 1])) as res, toTypeName(res); -- { serverError 44 }
+select mapAdd(([toFloat32(1), 2], [toFloat64(1.1), 1]), ([toFloat32(1), 2], [2.2, 1])) as res, toTypeName(res); -- { serverError 43 }
 select mapAdd(([1, 2], [toFloat64(1.1), 1]), ([1, 2], [1, 1])) as res, toTypeName(res); -- { serverError 43 }
 select mapAdd((['a', 'b'], [1, 1]), ([key], [1])) from values('key String', ('b'), ('c'), ('d'));
 select mapAdd((cast(['a', 'b'], 'Array(FixedString(1))'), [1, 1]), ([key], [1])) as res, toTypeName(res) from values('key FixedString(1)', ('b'), ('c'), ('d'));

tests/queries/0_stateless/01318_map_add_map_subtract_on_map_type.reference

@@ -0,0 +1,55 @@
+{1:5}
+{1:3,2:2}
+{1:3,3:2}
+{1:3,4:2}
+{1:3,5:2}
+{1:3,6:2}
+{1:3,7:2}
+{1:3,8:2}
+{1:3,9:2}
+{1:3,10:2}
+{1:5,2:2}
+{1:3,2:4}
+{1:3,2:2,3:2}
+{1:3,2:2,4:2}
+{1:3,2:2,5:2}
+{1:3,2:2,6:2}
+{1:3,2:2,7:2}
+{1:3,2:2,8:2}
+{1:3,2:2,9:2}
+{1:3,2:2,10:2}
+{1:2,2:2}	Map(UInt8,UInt64)
+{1:2,2:2}	Map(UInt16,UInt64)
+{1:2,2:2}	Map(UInt32,UInt64)
+{1:2,2:2}	Map(UInt64,UInt64)
+{1:2,2:2}	Map(UInt128,UInt128)
+{1:2,2:2}	Map(UInt256,UInt256)
+{1:2,2:2}	Map(Int16,UInt64)
+{1:2,2:2}	Map(Int16,Int64)
+{1:2,2:2}	Map(Int32,Int64)
+{1:2,2:2}	Map(Int64,Int64)
+{1:2,2:2}	Map(Int128,Int128)
+{1:2,2:2}	Map(Int256,Int256)
+{1:3.300000023841858,2:2}	Map(UInt8,Float64)
+{1:3.3000000000000003,2:2}	Map(UInt8,Float64)
+{'a':1,'b':2}
+{'a':1,'b':1,'c':1}
+{'a':1,'b':1,'d':1}
+{'a':1,'b':2}	Map(String,UInt64)
+{'a':1,'b':1,'c':1}	Map(String,UInt64)
+{'a':1,'b':1,'d':1}	Map(String,UInt64)
+{'a':1,'b':2}
+{'a':1,'b':1,'c':1}
+{'a':1,'b':1,'d':1}
+{'a':2}	Map(Enum16(\'a\' = 1, \'b\' = 2),Int64)
+{'b':2}	Map(Enum16(\'a\' = 1, \'b\' = 2),Int64)
+{'a':2}	Map(Enum8(\'a\' = 1, \'b\' = 2),Int64)
+{'b':2}	Map(Enum8(\'a\' = 1, \'b\' = 2),Int64)
+{'00000000-89ab-cdef-0123-456789abcdef':2}	Map(UUID,Int64)
+{'11111111-89ab-cdef-0123-456789abcdef':4}	Map(UUID,Int64)
+{1:0,2:0}	Map(UInt8,UInt64)
+{1:18446744073709551615,2:18446744073709551615}	Map(UInt8,UInt64)
+{1:-1,2:-1}	Map(UInt8,Int64)
+{1:-1.0999999761581423,2:0}	Map(UInt8,Float64)
+{1:-1,2:-1}	Map(UInt8,Int64)
+{1:-2,2:-2,3:1}	Map(UInt8,Int64)

tests/queries/0_stateless/01318_map_add_map_subtract_on_map_type.sql

@@ -0,0 +1,46 @@
+drop table if exists mapop_test;
+set allow_experimental_map_type = 1;
+create table mapop_test engine=TinyLog() as (select map(1, toInt32(2), number, 2) as m from numbers(1, 10));
+
+-- mapAdd
+select mapAdd(map(1, 1)); -- { serverError 42 }
+select mapAdd(map(1, 1), m) from mapop_test; -- { serverError 43 }
+
+select mapAdd(map(toUInt64(1), toInt32(1)), m) from mapop_test;
+select mapAdd(cast(m, 'Map(UInt8, UInt8)'), map(1, 1), map(2,2)) from mapop_test;
+
+-- cleanup
+drop table mapop_test;
+
+-- check types
+select mapAdd(map(toUInt8(1), 1, 2, 1), map(toUInt8(1), 1, 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toUInt16(1), toUInt16(1), 2, 1), map(toUInt16(1), toUInt16(1), 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toUInt32(1), toUInt32(1), 2, 1), map(toUInt32(1), toUInt32(1), 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toUInt64(1), toUInt64(1), 2, 1), map(toUInt64(1), toUInt64(1), 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toUInt128(1), toUInt128(1), 2, 1), map(toUInt128(1), toUInt128(1), 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toUInt256(1), toUInt256(1), 2, 1), map(toUInt256(1), toUInt256(1), 2, 1)) as res, toTypeName(res);
+
+select mapAdd(map(toInt8(1), 1, 2, 1), map(toInt8(1), 1, 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toInt16(1), toInt16(1), 2, 1), map(toInt16(1), toInt16(1), 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toInt32(1), toInt32(1), 2, 1), map(toInt32(1), toInt32(1), 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toInt64(1), toInt64(1), 2, 1), map(toInt64(1), toInt64(1), 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toInt128(1), toInt128(1), 2, 1), map(toInt128(1), toInt128(1), 2, 1)) as res, toTypeName(res);
+select mapAdd(map(toInt256(1), toInt256(1), 2, 1), map(toInt256(1), toInt256(1), 2, 1)) as res, toTypeName(res);
+
+select mapAdd(map(1, toFloat32(1.1), 2, 1), map(1, 2.2, 2, 1)) as res, toTypeName(res);
+select mapAdd(map(1, toFloat64(1.1), 2, 1), map(1, 2.2, 2, 1)) as res, toTypeName(res);
+select mapAdd(map(1, toFloat64(1.1), 2, 1), map(1, 1, 2, 1)) as res, toTypeName(res); -- { serverError 43 }
+select mapAdd(map('a', 1, 'b', 1), map(key, 1)) from values('key String', ('b'), ('c'), ('d'));
+select mapAdd(map(cast('a', 'FixedString(1)'), 1, 'b', 1), map(key, 1)) as res, toTypeName(res) from values('key String', ('b'), ('c'), ('d'));
+select mapAdd(map(cast('a', 'LowCardinality(String)'), 1, 'b', 1), map(key, 1)) from values('key String', ('b'), ('c'), ('d'));
+select mapAdd(map(key, val), map(key, val)) as res, toTypeName(res) from values ('key Enum16(\'a\'=1, \'b\'=2), val Int16',  ('a', 1), ('b', 1));
+select mapAdd(map(key, val), map(key, val)) as res, toTypeName(res) from values ('key Enum8(\'a\'=1, \'b\'=2), val Int16',  ('a', 1), ('b', 1));
+select mapAdd(map(key, val), map(key, val)) as res, toTypeName(res) from values ('key UUID, val Int32', ('00000000-89ab-cdef-0123-456789abcdef', 1), ('11111111-89ab-cdef-0123-456789abcdef', 2));
+
+-- mapSubtract, same rules as mapAdd
+select mapSubtract(map(toUInt8(1), 1, 2, 1), map(toUInt8(1), 1, 2, 1)) as res, toTypeName(res);
+select mapSubtract(map(toUInt8(1), 1, 2, 1), map(toUInt8(1), 2, 2, 2)) as res, toTypeName(res); -- overflow
+select mapSubtract(map(toUInt8(1), toInt32(1), 2, 1), map(toUInt8(1), toInt16(2), 2, 2)) as res, toTypeName(res);
+select mapSubtract(map(1, toFloat32(1.1), 2, 1), map(1, 2.2, 2, 1)) as res, toTypeName(res);
+select mapSubtract(map(toUInt8(1), toInt32(1), 2, 1), map(toUInt8(1), toInt16(2), 2, 2)) as res, toTypeName(res);
+select mapSubtract(map(toUInt8(3), toInt32(1)), map(toUInt8(1), toInt32(2), 2, 2)) as res, toTypeName(res);

tests/queries/0_stateless/01933_client_replxx_convert_history.expect

@@ -0,0 +1,33 @@
+#!/usr/bin/expect -f
+
+log_user 0
+set timeout 60
+match_max 100000
+# A default timeout action is to do nothing, change it to fail
+expect_after {
+    timeout {
+        exit 1
+    }
+}
+set basedir [file dirname $argv0]
+
+exec bash -c "echo select 1 > $argv0.txt"
+exec bash -c "echo select 1 >> $argv0.txt"
+exec bash -c "echo select 1 >> $argv0.txt"
+
+spawn bash -c "source $basedir/../shell_config.sh ; \$CLICKHOUSE_CLIENT_BINARY \$CLICKHOUSE_CLIENT_OPT --history_file=$argv0.txt"
+expect "The history file ($argv0.txt) is in old format. 3 lines, 1 unique lines."
+expect ":) "
+send -- "\4"
+expect eof
+
+spawn bash -c "wc -l $argv0.txt"
+# The following lines are expected:
+#
+#     ### YYYY-MM-DD HH:MM:SS.SSS
+#     select 1
+#
+expect "2"
+expect eof
+
+exec bash -c "rm $argv0.txt"

tests/queries/skip_list.json

@@ -851,6 +851,7 @@
         "01913_replace_dictionary",
         "01914_exchange_dictionaries",
         "01915_create_or_replace_dictionary",
-        "01925_test_storage_merge_aliases"
+        "01925_test_storage_merge_aliases",
+        "01933_client_replxx_convert_history" /// Uses non unique history file
     ]
 }

website/templates/index/community.html

@@ -66,7 +66,7 @@
                 </div>
                 <div class="row mb-3">
                     <div class="col w-100">
-                        <a href="https://join.slack.com/t/clickhousedb/shared_invite/zt-qfort0u8-TWqK4wIP0YSdoDE0btKa1w"
+                        <a href="https://join.slack.com/t/clickhousedb/shared_invite/zt-rxm3rdrk-lIUmhLC3V8WTaL0TGxsOmg"
                             rel="external nofollow noreferrer" target="_blank" class="text-decoration-none">
                             <div class="bg-dark p-4">
                                 <img data-src="/images/index/slack.svg"