Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

object_shared_* MergeTree table settings

These settings are available in system.merge_tree_settings and are autogenerated from ClickHouse source.

object_shared_data_buckets_for_compact_part

Type
NonZeroUInt64
Default
8
Version history
VersionDefault valueComment
25.88Add a setting to control number of buckets for shared data in JSON serialization in compact parts

The number of buckets for JSON shared data serialization in Compact parts. Works with map_with_buckets and advanced shared data serializations. The maximum allowed value is 256.

object_shared_data_buckets_for_wide_part

Type
NonZeroUInt64
Default
32
Version history
VersionDefault valueComment
25.832Add a setting to control number of buckets for shared data in JSON serialization in wide parts

The number of buckets for JSON shared data serialization in Wide parts. Works with map_with_buckets and advanced shared data serializations. The maximum allowed value is 256.

object_shared_data_serialization_version

Type
MergeTreeObjectSharedDataSerializationVersion
Default
advanced
Version history
VersionDefault valueComment
25.8mapAdd a setting to control JSON serialization versions
25.12advancedEnable advanced shared data serialization version by default

Serialization version for shared data inside JSON data type.

Possible values:

  • map - store shared data as Map(String, String)
  • map_with_buckets - store shared data as several separate Map(String, String) columns. Using buckets improves reading individual paths from shared data.
  • advanced - special serialization of shared data designed to significantly improve reading of individual paths from shared data. Note that this serialization increases the shared data storage size on disk because we store a lot of additional information.

The number of buckets for map_with_buckets and advanced serializations is determined by settings object_shared_data_buckets_for_compact_part/object_shared_data_buckets_for_wide_part.

object_shared_data_serialization_version_for_zero_level_parts

Type
MergeTreeObjectSharedDataSerializationVersion
Default
map_with_buckets
Version history
VersionDefault valueComment
25.8mapAdd a setting to control JSON serialization versions for zero level parts
25.12map_with_bucketsEnable map_with_buckets shared data serialization version for zero level parts by default

This setting allows to specify different serialization version of the shared data inside JSON type for zero level parts that are created during inserts. It’s recommended not to use advanced shared data serialization for zero level parts because it can increase the insertion time significantly.

Navigation