UPDATE

Оператор легковесного UPDATE обновляет строки в таблице [db.]table, которые соответствуют выражению filter_expr. Он называется "легковесным обновлением" в отличие от запроса ALTER TABLE ... UPDATE, который представляет собой ресурсоёмкий процесс и переписывает целые столбцы в частях данных. Он доступен только для семейства движков таблиц MergeTree.

UPDATE [db.]table [ON CLUSTER cluster] SET column1 = expr1 [, ...] [IN PARTITION partition_expr] WHERE filter_expr;

filter_expr должен иметь тип UInt8. Этот запрос обновляет значения указанных столбцов значениями соответствующих выражений в тех строках, где filter_expr принимает ненулевое значение. Значения приводятся к типу столбца с помощью оператора CAST. Обновление столбцов, используемых при вычислении основного ключа или ключа партиционирования, не поддерживается.

UPDATE hits SET Title = 'Updated Title' WHERE EventDate = today();

UPDATE wikistat SET hits = hits + 1, time = now() WHERE path = 'ClickHouse';

Легковесный UPDATE реализован с помощью патч-частей — особого вида частей данных, которые содержат только обновлённые столбцы и строки. Легковесный UPDATE создаёт патч-части, но не вносит немедленных физических изменений в исходные данные в хранилище. Процесс обновления похож на запрос INSERT ... SELECT ..., но запрос UPDATE ждёт завершения создания патч-части, прежде чем завершиться.

Обновлённые значения:

• Сразу видны в запросах SELECT за счёт применения патчей
• Физически материализуются только во время последующих слияний и мутаций
• Автоматически удаляются после того, как патчи будут материализованы во всех активных частях

Легковесные обновления поддерживаются для движков MergeTree, ReplacingMergeTree, CollapsingMergeTree, VersionedCollapsingMergeTree, а также их версий Replicated и Shared.

Чтобы использовать легковесные обновления, нужно включить материализацию столбцов _block_number и _block_offset с помощью настроек таблицы enable_block_number_column и enable_block_offset_column.

Запрос легковесного DELETE можно выполнить как легковесный UPDATE, а не как мутацию ALTER UPDATE. Реализация легковесного DELETE управляется настройкой lightweight_delete_mode.

Преимущества легковесных обновлений:

• Задержка обновления сопоставима с задержкой запроса INSERT ... SELECT ...
• Записываются только обновлённые столбцы и значения, а не столбцы целиком в частях данных
• Не нужно ждать завершения уже выполняющихся слияний/мутаций, поэтому задержка обновления предсказуема
• Возможно параллельное выполнение легковесных обновлений

Возможное влияние на производительность:

• Добавляют накладные расходы для запросов SELECT, в которых нужно применять патчи
• Индексы пропуска данных не будут использоваться для столбцов в частях данных, к которым нужно применить патчи. Проекции не будут использоваться, если у таблицы есть патч-части, в том числе для частей данных, к которым патчи применять не нужно.
• Небольшие, но слишком частые обновления могут привести к ошибке "слишком много частей". Рекомендуется объединять несколько обновлений в один запрос, например поместив идентификаторы обновляемых строк в одно условие IN в WHERE
• Легковесные обновления рассчитаны на обновление небольшого количества строк (примерно до 10% таблицы). Если нужно обновить больший объём данных, рекомендуется использовать мутацию ALTER TABLE ... UPDATE

Легковесные обновления, в отличие от тяжёлых мутаций, не ждут завершения текущих слияний/мутаций. Согласованность параллельных легковесных обновлений определяется настройками update_sequential_consistency и update_parallel_mode.

Для UPDATE требуется привилегия ALTER UPDATE. Чтобы разрешить команды UPDATE для конкретной таблицы указанному пользователю, выполните:

GRANT ALTER UPDATE ON db.table TO username;

Патч-части — это обычные части, но они содержат только обновлённые столбцы и несколько системных столбцов:

• _part - имя исходной части
• _part_offset - номер строки в исходной части
• _block_number - номер блока строки в исходной части
• _block_offset - смещение строки в блоке исходной части
• _data_version - версия обновлённых данных (номер блока, выделенный для запроса UPDATE)

В среднем это даёт около 40 байт накладных расходов (несжатых данных) на каждую обновлённую строку в патч-частях. Системные столбцы помогают находить строки в исходной части, которые нужно обновить. Системные столбцы связаны с виртуальными столбцами в исходной части, которые добавляются при чтении, если требуется применить патч-части. Патч-части сортируются по _part и _part_offset.

Патч-части принадлежат другим партициям, чем исходная часть. Идентификатор партиции патч-части имеет вид patch-<hash of column names in patch part>-<original_partition_id>. Поэтому патч-части с разными столбцами хранятся в разных партициях. Например, три обновления SET x = 1 WHERE <cond>, SET y = 1 WHERE <cond> и SET x = 1, y = 1 WHERE <cond> создадут три патч-части в трёх разных партициях.

Патч-части могут сливаться между собой, чтобы уменьшить число применяемых патчей в запросах SELECT и снизить накладные расходы. Для слияния патч-частей используется алгоритм слияния replacing с _data_version в качестве version column. Поэтому патч-части всегда хранят последнюю версию для каждой обновлённой строки в части.

Легковесные обновления не ждут завершения текущих слияний и мутаций и всегда используют текущий снимок частей данных, чтобы выполнить обновление и создать патч-часть. Из-за этого возможны два случая применения патч-частей.

Например, если мы читаем часть A, нужно применить патч-часть X:

• если X содержит саму часть A. Это происходит, если A не участвовала в слиянии на момент выполнения UPDATE.
• если X содержит части B и C, которые покрываются частью A. Это происходит, если на момент выполнения UPDATE выполнялось слияние (B, C) -> A.

Для этих двух случаев есть два соответствующих способа применения патч-частей:

• Использование слияния по отсортированным столбцам _part, _part_offset.
• Использование JOIN по столбцам _block_number, _block_offset.

Режим JOIN медленнее и требует больше памяти, чем режим слияния, но используется реже.

• ALTER UPDATE — тяжёлые операции UPDATE
• Легковесный DELETE — операции легковесного DELETE
• APPLY PATCHES — принудительная физическая материализация патчей в частях данных (операция мутации)