Skip to main content
これらの設定は system.merge_tree_settings で確認でき、ClickHouse のソースコードから自動生成されています。

object_shared_data_buckets_for_compact_part

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

object_shared_data_buckets_for_wide_part

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

object_shared_data_serialization_version

JSON データ型内の 共有データシリアル化バージョン。 設定可能な値:
  • map - 共有データ を Map(String, String) として保存します
  • map_with_buckets - 共有データ を複数の個別の Map(String, String) カラムとして保存します。バケットを使用すると、共有データ から個々のパスをより効率よく読み取れます。
  • advanced - 共有データ から個々のパスの読み取りを大幅に改善するために設計された、共有データ 向けの特別なシリアライゼーションです。 このシリアライゼーションでは多くの追加情報を保存するため、ディスク上で 共有データ の保存サイズが増加する点に注意してください。
  • advanced_chunked - advanced と同様ですが、多数の一意なパスを持つ JSON カラムのマージ時にピークメモリを削減するため、シリアライゼーション中に行をより小さな chunk に分割できます。chunk サイズは object_shared_data_target_chunk_rows 設定で制御されます。
map_with_buckets、advanced、および advanced_chunked シリアライゼーションのバケット数は、次の設定によって決まります object_shared_data_buckets_for_compact_part/object_shared_data_buckets_for_wide_part。

object_shared_data_serialization_version_for_zero_level_parts

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

object_shared_data_target_chunk_rows

advanced_chunked JSON 共有データシリアル化における chunk あたりの目標行数です。 これは hard limit ではありません。最後の chunk が目標値の半分未満になる場合は直前の chunk とマージされるため、実際の chunk サイズは target/2 から 1.5 * target の範囲になります。 値を小さくすると、多数の 一意なパス を含む JSON カラムのマージ時の peak memory を抑えられますが、その分 chunk 数は増加します。
最終更新日 2026年9月26日