При структуре flat словарь полностью хранится в памяти в виде плоских массивов.
Объем используемой памяти пропорционален размеру самого большого ключа.
Этот тип структуры обеспечивает наилучшую производительность среди всех доступных способов хранения словаря.
Ключ словаря имеет тип UInt64, а значение ограничено max_array_size (по умолчанию — 500,000).
Если при создании словаря обнаруживается ключ большего размера, ClickHouse генерирует исключение и не создает словарь.
Начальный размер плоских массивов словаря задается настройкой initial_array_size (по умолчанию — 1024).
Поддерживаются все типы источников.
При обновлении словаря данные (из файла или из таблицы) считываются полностью.
Пример конфигурации:
Последнее изменение 2 июля 2026 г.