ssd_cache 字典布局类型 - ClickHouse Documentation

ssd_cache

与 cache 类似，但数据存储在 SSD 上，索引存储在 RAM 中。所有与更新队列相关的缓存字典设置同样适用于 SSD 缓存字典。与 cache 一样，该布局不记录存在哪些键，因此使用 SELECT ... FROM <dictionary> 将其作为表读取时，只会返回当前已缓存且持有值的单元：它无法发现缓存中不存在的键，也会跳过那些记录了已查询但在 source 中未找到的键的默认单元。已过期的驻留单元仍会重新向 source 发起请求。参见 cache。字典键的类型为 UInt64。

DDL
配置文件

LAYOUT(SSD_CACHE(BLOCK_SIZE 4096 FILE_SIZE 16777216 READ_BUFFER_SIZE 1048576
    PATH '/var/lib/clickhouse/user_files/test_dict'))

<layout>
    <ssd_cache>
        <!-- 基本读取块大小（以字节为单位）。建议与 SSD 的页大小相同。 -->
        <block_size>4096</block_size>
        <!-- 缓存文件的最大大小（以字节为单位）。 -->
        <file_size>16777216</file_size>
        <!-- 用于从 SSD 读取元素的 RAM 缓冲区大小（以字节为单位）。 -->
        <read_buffer_size>131072</read_buffer_size>
        <!-- 刷新到 SSD 前，用于聚合元素的 RAM 缓冲区大小（以字节为单位）。 -->
        <write_buffer_size>1048576</write_buffer_size>
        <!-- 缓存文件的存储路径。 -->
        <path>/var/lib/clickhouse/user_files/test_dict</path>
    </ssd_cache>
</layout>

complex_key_ssd_cache

这种存储类型适用于复合键，与 ssd_cache 类似。

最后修改于 2026年9月26日