Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

object_shared_* MergeTree 表设置

这些设置可在 system.merge_tree_settings 中查看,且由 ClickHouse 源代码自动生成。

object_shared_data_buckets_for_compact_part

类型
NonZeroUInt64
默认值
8
版本历史
版本默认值注释
25.88新增一个设置,用于控制 compact parts 中 JSON 共享数据序列化的桶数量

用于 compact parts 中 JSON 共享数据序列化的桶数量。与 map_with_bucketsadvanced 共享数据序列化配合使用。 允许的最大值为 256。

object_shared_data_buckets_for_wide_part

类型
NonZeroUInt64
默认值
32
版本历史
版本默认值注释
25.832新增一个设置,用于控制 wide parts 中 JSON 共享数据序列化的桶数量

用于 wide parts 中 JSON 共享数据序列化的桶数量。与 map_with_bucketsadvanced 共享数据序列化配合使用。 允许的最大值为 256。

object_shared_data_serialization_version

类型
MergeTreeObjectSharedDataSerializationVersion
默认值
advanced
版本历史
版本默认值注释
25.8map新增用于控制 JSON 序列化版本的设置
25.12advanced默认启用高级共享数据序列化版本

JSON 数据类型内共享数据的序列化版本。

可能的值:

  • map - 将共享数据存储为 Map(String, String)
  • map_with_buckets - 将共享数据存储为多个独立的 Map(String, String) 列。使用桶可以提升从共享数据中读取单个路径的性能。
  • advanced - 一种专为共享数据设计的特殊序列化方式,可显著提升从共享数据中读取单个路径的性能。 请注意,这种序列化会增加磁盘上共享数据的存储大小,因为会存储大量额外信息。

map_with_bucketsadvanced 序列化的桶数量由以下设置决定: object_shared_data_buckets_for_compact_part/object_shared_data_buckets_for_wide_part

object_shared_data_serialization_version_for_zero_level_parts

类型
MergeTreeObjectSharedDataSerializationVersion
默认值
map_with_buckets
版本历史
版本默认值注释
25.8map新增一个设置,用于控制零级 parts 的 JSON 序列化版本
25.12map_with_buckets默认对零级 parts 启用 map_with_buckets 共享数据序列化版本

此设置允许为插入期间创建的零级 parts 中,JSON 类型内部的共享数据指定不同的序列化版本。 建议不要对零级 parts 使用 advanced 共享数据序列化,因为它可能会显著增加 插入时间。

Navigation