CoalescingMergeTree

从版本 25.6 开始提供

该表引擎从版本 25.6 及更高版本在 OSS 和 Cloud 中提供。

该引擎继承自 MergeTree。主要区别在于数据分片的合并方式：对于 CoalescingMergeTree 表，ClickHouse 会将所有具有相同主键（或者更准确地说，具有相同的排序键）的行替换为一行，该行包含每列的最新非 NULL 值。

这使得列级的 upserts 成为可能，这意味着您可以仅更新特定的列，而不是整个行。

CoalescingMergeTree 旨在与非键列中的 Nullable 类型一起使用。如果列不是 Nullable，则行为与 ReplacingMergeTree 相同。

创建表

CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
(
    name1 [type1] [DEFAULT|MATERIALIZED|ALIAS expr1],
    name2 [type2] [DEFAULT|MATERIALIZED|ALIAS expr2],
    ...
) ENGINE = CoalescingMergeTree([columns])
[PARTITION BY expr]
[ORDER BY expr]
[SAMPLE BY expr]
[SETTINGS name=value, ...]

有关请求参数的描述，请参阅请求描述。

CoalescingMergeTree 的参数

列

columns - 一个包含将要合并的列名的元组。可选参数。这些列必须是数字类型，并且不得在分区或排序键中。

如果未指定 columns，ClickHouse 将合并所有不在排序键中的列的值。

查询子句

创建 CoalescingMergeTree 表时，所需的子句与创建 MergeTree 表时相同。

创建表的弃用方法

备注

在新项目中不要使用此方法，如果可能，请将旧项目切换到上述方法。

CREATE TABLE [IF NOT EXISTS] [db.]table_name [ON CLUSTER cluster]
(
    name1 [type1] [DEFAULT|MATERIALIZED|ALIAS expr1],
    name2 [type2] [DEFAULT|MATERIALIZED|ALIAS expr2],
    ...
) ENGINE [=] CoalescingMergeTree(date-column [, sampling_expression], (primary, key), index_granularity, [columns])

除了 columns 之外，所有参数的含义与 MergeTree 相同。

columns — 一个包含将被合并的列名的元组。可选参数。有关描述，请参见上面的文字。

示例

考虑以下表：

CREATE TABLE test_table
(
    key UInt64,
    value_int Nullable(UInt32),
    value_string Nullable(String),
    value_date Nullable(Date)
)
ENGINE = CoalescingMergeTree()
ORDER BY key

向其中插入数据：

INSERT INTO test_table VALUES(1, NULL, NULL, '2025-01-01'), (2, 10, 'test', NULL);
INSERT INTO test_table VALUES(1, 42, 'win', '2025-02-01');
INSERT INTO test_table(key, value_date) VALUES(2, '2025-02-01');

结果将如下所示：

SELECT * FROM test_table ORDER BY key;

┌─key─┬─value_int─┬─value_string─┬─value_date─┐
│   1 │        42 │ win          │ 2025-02-01 │
│   1 │      ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ         │ 2025-01-01 │
│   2 │      ᴺᵁᴸᴸ │ ᴺᵁᴸᴸ         │ 2025-02-01 │
│   2 │        10 │ test         │       ᴺᵁᴸᴸ │
└─────┴───────────┴──────────────┴────────────┘

推荐的查询以获得正确和最终的结果：

SELECT * FROM test_table FINAL ORDER BY key;

┌─key─┬─value_int─┬─value_string─┬─value_date─┐
│   1 │        42 │ win          │ 2025-02-01 │
│   2 │        10 │ test         │ 2025-02-01 │
└─────┴───────────┴──────────────┴────────────┘

使用 FINAL 修饰符强制 ClickHouse 在查询时应用合并逻辑，确保您获得每列的正确合并的“最新”值。这是在从 CoalescingMergeTree 表中查询时最安全和最准确的方法。

备注

如果基础分片尚未完全合并，则使用 GROUP BY 的方法可能会返回不正确的结果。

SELECT key, last_value(value_int), last_value(value_string), last_value(value_date)  FROM test_table GROUP BY key; -- Not recommended.

创建表​

CoalescingMergeTree 的参数​

列​

查询子句​

示例​

创建表

CoalescingMergeTree 的参数

列

查询子句

示例