> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# flat 字典布局

> 以扁平数组形式将字典存储在内存中。

使用 `flat` 布局时，字典会以扁平数组形式完整存储在内存中。
所用内存与最大键的大小 (即占用空间) 成正比。

<Tip>
  在所有可用的字典存储方法中，此布局类型的性能最佳。
</Tip>

字典键的类型为 [UInt64](/zh/reference/data-types/int-uint)，其值受 `max_array_size` 限制 (默认值为 500,000) 。
如果在创建字典时发现更大的键，ClickHouse 会抛出异常，并且不会创建该字典。
字典扁平数组的初始大小由 `initial_array_size` 设置控制 (默认值为 1024) 。

支持所有类型的源。
更新字典时，会完整读取全部数据 (来自文件或表) 。

配置示例：

<Tabs>
  <Tab title="DDL">
    ```sql theme={null}
    LAYOUT(FLAT(INITIAL_ARRAY_SIZE 50000 MAX_ARRAY_SIZE 5000000))
    ```
  </Tab>

  <Tab title="配置文件">
    ```xml theme={null}
    <layout>
      <flat>
        <initial_array_size>50000</initial_array_size>
        <max_array_size>5000000</max_array_size>
      </flat>
    </layout>
    ```
  </Tab>
</Tabs>

<br />