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.88compact パーツにおける JSON シリアル化の共有データのバケット数を制御する設定を追加

compact パーツにおける JSON の共有データシリアル化のバケット数です。map_with_buckets および advanced の共有データシリアル化で機能します。 指定可能な最大値は 256 です。

object_shared_data_buckets_for_wide_part

NonZeroUInt64
デフォルト値
32
バージョン履歴
バージョンデフォルト値コメント
25.832wide パーツ内の JSON シリアル化における共有データのバケット数を制御する設定を追加

wide パーツにおける JSON シリアル化の共有データ用バケット数です。map_with_buckets および advanced の共有データシリアル化で機能します。 許容される最大値は 256 です。

object_shared_data_serialization_version

MergeTreeObjectSharedDataSerializationVersion
デフォルト値
advanced
バージョン履歴
バージョンデフォルト値コメント
25.8mapJSON シリアル化バージョンを制御する設定を追加
25.12advancedadvanced の 共有データ シリアル化バージョンをデフォルトで有効化

JSON データ型内の 共有データ のシリアル化バージョン。

設定可能な値:

  • map - 共有データ を Map(String, String) として保存します
  • map_with_buckets - 共有データ を複数の個別の Map(String, String) カラムとして保存します。バケットを使用すると、共有データ から個々のパスをより効率よく読み取れます。
  • advanced - 共有データ から個々のパスの読み取りを大幅に改善するために設計された、共有データ 向けの特別なシリアライゼーションです。 このシリアライゼーションでは多くの追加情報を保存するため、ディスク上で 共有データ の保存サイズが増加する点に注意してください。

map_with_buckets および advanced シリアライゼーションのバケット数は、次の設定によって決まります 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ゼロレベルパーツ向けの JSON シリアル化バージョンを制御する設定を追加
25.12map_with_bucketsゼロレベルパーツで map_with_buckets の共有データ シリアル化バージョンをデフォルトで有効化

この設定では、insert 時に作成されるゼロレベルパーツについて、 JSON 型内の共有データに使用するシリアル化バージョンを指定できます。 ゼロレベルパーツに advanced の共有データ シリアル化を使用することは推奨されません。挿入にかかる時間が 大幅に増加する可能性があるためです。

Navigation