4.7 KiB
| slug | sidebar_label | title | keywords | |
|---|---|---|---|---|
| /ja/guides/developer/lightweight-update | 論理更新 | 論理更新 |
|
論理更新
:::note 論理更新はClickHouse Cloudでのみ利用可能です。 :::
論理更新が有効な場合、更新された行は即座に更新済みとしてマークされ、後続のSELECTクエリは自動的に変更された値を返します。論理更新が有効でない場合は、バックグラウンド処理でミューテーションが適用されるのを待つ必要があるかもしれません。
論理更新は、MergeTreeファミリーのテーブルに対してクエリレベルの設定apply_mutations_on_flyを有効にすることで使用できます。
SET apply_mutations_on_fly = 1;
例
テーブルを作成し、いくつかのミューテーションを実行してみましょう：
CREATE TABLE test_on_fly_mutations (id UInt64, v String)
ENGINE = MergeTree ORDER BY id;
-- 論理更新が有効でない場合のデフォルトの動作を示すために
-- ミューテーションのバックグラウンドの具体化を無効化
SYSTEM STOP MERGES test_on_fly_mutations;
SET mutations_sync = 0;
-- 新しいテーブルにいくつかの行を挿入
INSERT INTO test_on_fly_mutations VALUES (1, 'a'), (2, 'b'), (3, 'c');
-- 行の値を更新
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クエリで更新の結果を確認してみましょう：
-- 論理更新を明示的に無効化
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 │
└────┴───┘
論理更新を有効にするとどうなるかを見てみましょう：
-- 論理更新を有効化
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の設定をnumber_of_mutations_to_throwやnumber_of_mutations_to_delayといった他のMergeTreeレベルの設定と併せて有効にすることをお勧めします。
サブクエリと非決定的な関数のサポート
論理更新は、サブクエリと非決定的な関数に対して限定的なサポートを提供します。妥当なサイズ（設定mutations_max_literal_size_to_replaceで制御される）の結果を持つスカラーサブクエリのみがサポートされています。また、定数の非決定的な関数（例:now()関数）のみがサポートされています。
これらの動作は次の設定によって制御されます：
mutations_execute_nondeterministic_on_initiator- trueの場合、非決定的な関数はイニシエーターレプリカで実行され、UPDATEやDELETEクエリでリテラルとして置き換えられます。デフォルト値：false。mutations_execute_subqueries_on_initiator- trueの場合、スカラーサブクエリはイニシエーターレプリカで実行され、UPDATEやDELETEクエリでリテラルとして置き換えられます。デフォルト値：false。mutations_max_literal_size_to_replace-UPDATEやDELETEクエリで置き換えるリテラルのシリアライズされた最大サイズ（バイト単位）。デフォルト値：16384（16 KiB）。