Сначала докажите stale value одним контрольным ключом на одном и том же ClickHouse node: значение в source уже новое, а `dictGet` старое. Затем откройте `system.dictionaries`. Ручной `SYSTEM RELOAD DICTIONARY` можно использовать после этой фиксации, но его `Ok.` не подтверждает успешное обновление — состояние и `last_exception` нужно прочитать снова.
ClickHouse обновляет полно загруженные dictionaries по `LIFETIME`, сохраняя доступной старую версию во время refresh. При ошибке запросы могут продолжать читать старую версию. Поэтому пользователь видит «словарь работает», хотя последняя загрузка не прошла.
Status отделяет расписание от ошибки загрузки
SELECT
database, name, status, element_count,
formatReadableSize(bytes_allocated) AS memory,
query_count, hit_rate, found_rate, last_exception
FROM system.dictionaries
WHERE database = currentDatabase() AND name = 'example_dict';
SHOW CREATE DICTIONARY example_dict;Замените имя и базу; запросы read-only, но `last_exception` может содержать hostname или текст источника, поэтому редактируйте вывод перед передачей. На кластере выполните проверку по каждому узлу: локальная system table не доказывает одинаковое состояние всех replicas.
Четыре варианта требуют разных действий
| Наблюдение | Причина | Следующий шаг |
|---|---|---|
| LIFETIME(0) | Refresh по таймеру отключён | Определить ручной/event-driven reload или ненулевой interval |
| FAILED и last_exception | Source, schema, auth или parse error | Исправить конкретную ошибку и повторить контроль |
| LOADED, но данные старые | invalidate_query не меняется или выбран другой source | Сравнить marker и connection target |
| Один node свежий, другой нет | Reload/config не дошёл до кластера | Проверить fully qualified name и все nodes |
| Часть строк не обновилась | Неверный update_field/update_lag | Проверить incremental boundary и late rows |
`LIFETIME(MIN x MAX y)` выбирает случайный момент в интервале, распределяя нагрузку на source. Нельзя ожидать одновременного refresh всех узлов. Если min и max равны нулю, таймер не перезагружает dictionary; обновление остаётся за изменением config или явной командой.
invalidate_query обязан менять одну строку-маркер
Для ODBC, PostgreSQL, ClickHouse и ряда других sources `invalidate_query` позволяет не скачивать данные, пока результат marker-query не изменился. Маркер должен меняться при любом релевантном обновлении. `max(updated_at)` не заметит исправление старой строки, если её timestamp не обновили; count не заметит замену значения без изменения числа строк.
- Выполните invalidate query тем же пользователем и на том же source.
- Сохраните старый и новый результат маркера как одну строку.
- Проверьте timezone и точность timestamp, если маркер основан на времени.
- Не включайте секрет или персональные данные в marker output.
- При нескольких source replicas убедитесь, что чтение не попадает на отстающую копию.
Incremental update может оставить поздние строки за границей
При `update_field` ClickHouse добавляет условие относительно времени предыдущего обновления; `update_lag` отодвигает границу назад и помогает подобрать поздние записи. Это не универсальная дедупликация: source query, ключ dictionary и семантика обновления должны возвращать корректное последнее значение для повторно захваченных строк.
Сначала тестируйте на одном dictionary и контрольных ключах. Слишком широкий lag или частый full reload увеличивает нагрузку на source. Если dictionary не помещается в память, смена layout может быть полезнее частых аварийных reload, но это отдельное измерение по bytes, hit rate и latency.
Ручной reload — тест, а не расписание
После `SYSTEM RELOAD DICTIONARY db.example_dict` снова прочитайте status, last_exception и контрольный `dictGet`. Для distributed cluster используйте согласованный DDL-процесс и fully qualified name; не предполагайте, что команда из одной сессии обновила все nodes. При неуспехе сохраните старую рабочую версию dictionary и не удаляйте её до восстановления source.
Приёмка: новый marker виден, каждый node имеет успешный status, два изменённых и один неизменённый ключ возвращают ожидаемые значения, а источник не получил всплеск соединений. Для разбора подготовьте SHOW CREATE без пароля, версию ClickHouse, system.dictionaries, тип source и timeline обновления.