> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# object_shared_* MergeTree 테이블 설정

> object_shared_* 생성 그룹에 속한 ClickHouse MergeTree 테이블 설정입니다.

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>유형</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>기본값</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          재시작 없이 변경 가능
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

이 설정은 [system.merge\_tree\_settings](/docs/ko/reference/system-tables/merge_tree_settings)에서 사용할 수 있으며, ClickHouse 소스 코드에서 자동으로 생성됩니다.

<div id="object_shared_data_buckets_for_compact_part">
  ## object\_shared\_data\_buckets\_for\_compact\_part
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="8" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "8"},{"label": "Compact 파트의 JSON 공유 데이터 직렬화에서 버킷 수를 제어하는 설정 추가"}]}]} />

Compact 파트의 JSON 공유 데이터 직렬화에서 사용하는 버킷 수입니다. `map_with_buckets` 및 `advanced` 공유 데이터 직렬화와 함께 작동합니다.
허용되는 최대값은 256입니다.

<div id="object_shared_data_buckets_for_wide_part">
  ## object\_shared\_data\_buckets\_for\_wide\_part
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="32" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "32"},{"label": "wide 파트의 JSON 공유 데이터 직렬화에서 버킷 수를 제어하는 설정 추가"}]}]} />

wide 파트의 JSON 공유 데이터 직렬화에 사용되는 버킷 수입니다. `map_with_buckets` 및 `advanced` 공유 데이터 직렬화와 함께 사용됩니다.
허용되는 최대값은 256입니다.

<div id="object_shared_data_serialization_version">
  ## object\_shared\_data\_serialization\_version
</div>

<SettingsInfoBlock type="MergeTreeObjectSharedDataSerializationVersion" default_value="advanced" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "map"},{"label": "JSON serialization version을 제어하는 설정 추가"}]}, {"id": "row-2","items": [{"label": "25.12"},{"label": "advanced"},{"label": "기본적으로 고급 공유 데이터 직렬화 버전 활성화"}]}]} />

JSON 데이터 타입 내부 공유 데이터의 직렬화 버전입니다.

Possible values:

* `map` - 공유 데이터를 `Map(String, String)`으로 저장합니다
* `map_with_buckets` - 공유 데이터를 여러 개의 개별 `Map(String, String)` 컬럼으로 저장합니다. 버킷을 사용하면 공유 데이터에서 개별 경로를 읽는 성능이 향상됩니다.
* `advanced` - 공유 데이터에서 개별 경로 읽기 성능을 크게 향상하도록 설계된 공유 데이터용 특수 serialization입니다.
  이 serialization은 많은 추가 정보를 저장하므로 디스크에서 공유 데이터의 저장 크기가 증가합니다.

`map_with_buckets` 및 `advanced` serialization의 버킷 수는 다음 설정에 따라 결정됩니다.
[object\_shared\_data\_buckets\_for\_compact\_part](/docs/ko/reference/settings/merge-tree-settings/object-shared#object_shared_data_buckets_for_compact_part)/[object\_shared\_data\_buckets\_for\_wide\_part](/docs/ko/reference/settings/merge-tree-settings/object-shared#object_shared_data_buckets_for_wide_part).

<div id="object_shared_data_serialization_version_for_zero_level_parts">
  ## object\_shared\_data\_serialization\_version\_for\_zero\_level\_parts
</div>

<SettingsInfoBlock type="MergeTreeObjectSharedDataSerializationVersion" default_value="map_with_buckets" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "map"},{"label": "0레벨 파트의 JSON 직렬화 버전을 제어하는 설정 추가"}]}, {"id": "row-2","items": [{"label": "25.12"},{"label": "map_with_buckets"},{"label": "기본적으로 0레벨 파트에 map_with_buckets 공유 데이터 직렬화 버전 활성화"}]}]} />

이 설정을 사용하면 삽입 중 생성되는 0레벨 파트의 JSON 타입 내부 공유 데이터에 대해
서로 다른 직렬화 버전을 지정할 수 있습니다.
`advanced` 공유 데이터 직렬화는 삽입 시간을 크게 늘릴 수 있으므로 0레벨 파트에는 사용하지 않는 것이 좋습니다.