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