跳至主要内容

轻量级更新

轻量级更新

注意

轻量级更新仅在 ClickHouse Cloud 上可用。

启用轻量级更新后,更新的行会立即被标记为已更新,后续的 SELECT 查询将自动返回更改后的值。如果未启用轻量级更新,您可能需要等待后台进程应用变异才能看到更改后的值。

可以通过启用查询级设置 apply_mutations_on_flyMergeTree 系列表启用轻量级更新。

SET apply_mutations_on_fly = 1;

示例

让我们创建一个表并运行一些变异

CREATE TABLE test_on_fly_mutations (id UInt64, v String) 
ENGINE = MergeTree ORDER BY id;

-- Disable background materialization of mutations to showcase
-- default behavior when lightweight updates are not enabled
SYSTEM STOP MERGES test_on_fly_mutations;
SET mutations_sync = 0;

-- Insert some rows in our new table
INSERT INTO test_on_fly_mutations VALUES (1, 'a'), (2, 'b'), (3, 'c');

-- Update the values of the rows
ALTER TABLE test_on_fly_mutations UPDATE v = 'd' WHERE id = 1;
ALTER TABLE test_on_fly_mutations DELETE WHERE v = 'd';
ALTER TABLE test_on_fly_mutations UPDATE v = 'e' WHERE id = 2;
ALTER TABLE test_on_fly_mutations DELETE WHERE v = 'e';

让我们通过 SELECT 查询检查更新的结果

-- Explicitly disable lightweight updates
SET apply_mutations_on_fly = 0;

SELECT id, v FROM test_on_fly_mutations ORDER BY id;

请注意,当我们查询新表时,行的值尚未更新

┌─id─┬─v─┐
│ 1 │ a │
│ 2 │ b │
│ 3 │ c │
└────┴───┘

现在让我们看看启用轻量级更新后会发生什么

-- Enable lightweight updates
SET apply_mutations_on_fly = 1;

SELECT id, v FROM test_on_fly_mutations ORDER BY id;

SELECT 查询现在立即返回正确的结果,而无需等待应用变异。

┌─id─┬─v─┐
│ 3 │ c │
└────┴───┘

性能影响

启用轻量级更新后,变异不会立即具体化,而只会在 SELECT 查询期间应用。但是,请注意,变异仍在后台异步具体化,这是一个繁重的过程。

如果在一段时间内提交的变异数量持续超过后台处理的变异数量,则必须应用的未具体化变异队列将继续增长。这将导致 SELECT 查询性能最终下降。

我们建议将 apply_mutations_on_fly 设置与其他 MergeTree 级别设置(如 number_of_mutations_to_thrownumber_of_mutations_to_delay)一起启用,以限制未具体化变异的无限增长。

子查询和非确定性函数的支持

轻量级更新对子查询和非确定性函数的支持有限。仅支持结果大小合理(由设置 mutations_max_literal_size_to_replace 控制)的标量子查询。仅支持常量非确定性函数(例如,函数 now())。

这些行为由以下设置控制

  • mutations_execute_nondeterministic_on_initiator - 如果为真,则在发起者副本上执行非确定性函数,并在 UPDATEDELETE 查询中将其替换为文字。默认值:false
  • mutations_execute_subqueries_on_initiator - 如果为真,则在发起者副本上执行标量子查询,并在 UPDATEDELETE 查询中将其替换为文字。默认值:false
  • mutations_max_literal_size_to_replace - 要在 UPDATEDELETE 查询中替换的序列化文字的最大大小(以字节为单位)。默认值:16384(16 KiB)。