ClickHouseデータの更新と削除 - ClickHouse Documentation

ClickHouse は大量の分析ワークロード向けに設計されていますが、状況によっては既存データの変更や削除を行うこともできます。これらの操作は「ミューテーション」と呼ばれ、ALTER TABLE コマンドを使用して実行します。

頻繁に更新を行う必要がある場合は、ClickHouse の重複排除の利用を検討してください。これにより、ミューテーションイベントを発生させることなく、行の更新や削除を行えます。あるいは、論理更新または論理削除を使用してください。

データの更新

テーブルの行を更新するには、ALTER TABLE...UPDATE コマンドを使用します。

ALTER TABLE [<database>.]<table> UPDATE <column> = <expression> WHERE <filter_expr>

<expression> は、<filter_expr> を満たすカラムの新しい値です。<expression> は、そのカラムと同じデータ型であるか、CAST 演算子を使って同じデータ型に変換できる必要があります。<filter_expr> は、データの各行に対して UInt8 (ゼロまたは非ゼロ) の値を返す必要があります。複数の UPDATE <column> ステートメントは、カンマ区切りで 1 つの ALTER TABLE コマンドにまとめられます。例:

次のようなミューテーションを使うと、Dictionary ルックアップで visitor_ids を新しいものに置き換えて更新できます。
ALTER TABLE website.clicks UPDATE visitor_id = getDict('visitors', 'new_visitor_id', visitor_id) WHERE visit_date < '2022-01-01'

1 つのコマンドで複数の値を変更したほうが、複数のコマンドに分けるより効率的な場合があります。

ALTER TABLE website.clicks
UPDATE url = substring(url, position(url, '://') + 3), visitor_id = new_visit_id
WHERE visit_date < '2022-01-01'

分片テーブルでは、ミューテーションを ON CLUSTER で実行できます。

ALTER TABLE clicks ON CLUSTER main_cluster
UPDATE click_count = click_count / 2
WHERE visitor_id ILIKE '%robot%'

プライマリキーまたはソートキーの一部であるカラムは更新できません。

データの削除

データを削除するには、ALTER TABLE コマンドを使用します。

ALTER TABLE [<database>.]<table> DELETE WHERE <filter_expr>

<filter_expr> は、データの各行に対して UInt8 値を返す必要があります。例

カラムの値が配列内のいずれかの値に含まれるレコードを削除します。
ALTER TABLE website.clicks DELETE WHERE visitor_id in (253, 1002, 4277)

このクエリは何を変更するでしょうか？

ALTER TABLE clicks ON CLUSTER main_cluster DELETE WHERE visit_date < '2022-01-02 15:00:00' AND page_id = '573'

テーブル内のすべてのデータを削除する場合は、TRUNCATE TABLE [<database].]<table> コマンドを使用するほうが効率的です。このコマンドは ON CLUSTER でも実行できます。

詳細は、DELETE ステートメントのドキュメントページを参照してください。

論理削除

行を削除するもう 1 つの方法として、論理削除と呼ばれる DELETE FROM コマンドがあります。削除された行は直ちに削除済みとしてマークされ、以降のすべてのクエリ結果から自動的に除外されるため、パーツのマージを待ったり、FINAL キーワードを使用したりする必要はありません。データのクリーンアップはバックグラウンドで非同期に実行されます。

DELETE FROM [db.]table [ON CLUSTER cluster] [WHERE expr]

たとえば、次のクエリは、Title カラムにテキスト hello を含む hits テーブル内のすべての行を削除します。

DELETE FROM hits WHERE Title LIKE '%hello%';

論理削除に関する補足:

この機能は、MergeTree テーブルエンジンファミリーでのみ利用できます。
論理削除はデフォルトで同期的に実行され、すべてのレプリカが削除を処理するまで待機します。この動作は、lightweight_deletes_sync 設定で制御されます。

​データの更新

​データの削除

​論理削除

データの更新

データの削除

論理削除