> ## 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.

# shared_merge_* MergeTree 테이블 설정

> shared_merge_* 생성 그룹에 포함된 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="shared_merge_tree_activate_coordinated_merges_tasks">
  ## shared\_merge\_tree\_activate\_coordinated\_merges\_tasks
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.9"},{"label": "0"},{"label": "새로운 설정"}]}, {"id": "row-2","items": [{"label": "25.8"},{"label": "0"},{"label": "새로운 설정"}]}, {"id": "row-3","items": [{"label": "25.7"},{"label": "0"},{"label": "새로운 설정"}]}, {"id": "row-4","items": [{"label": "25.6"},{"label": "0"},{"label": "새로운 설정"}]}, {"id": "row-5","items": [{"label": "25.10"},{"label": "0"},{"label": "새로운 설정"}]}]} />

조정된 머지 작업의 재스케줄링을 활성화합니다. 이는
shared\_merge\_tree\_enable\_coordinated\_merges=0인 경우에도 유용할 수 있습니다. 머지 코디네이터
통계를 채워 콜드 스타트에 도움이 되기 때문입니다.

<div id="shared_merge_tree_create_per_replica_metadata_nodes">
  ## shared\_merge\_tree\_create\_per\_replica\_metadata\_nodes
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "0"},{"label": "Keeper의 메타데이터 양을 줄입니다."}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "1"},{"label": "Cloud sync"}]}]} />

ZooKeeper에서 레플리카별 /metadata 및 /columns 노드를 생성할 수 있도록 합니다.
ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_disable_merges_and_mutations_assignment">
  ## shared\_merge\_tree\_disable\_merges\_and\_mutations\_assignment
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

shared merge tree의 머지 및 뮤테이션 할당을 중지합니다. ClickHouse
Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_empty_partition_lifetime">
  ## shared\_merge\_tree\_empty\_partition\_lifetime
</div>

<SettingsInfoBlock type="Seconds" default_value="86400" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.9"},{"label": "86400"},{"label": "새로운 설정"}]}]} />

파트가 없는 파티션을 Keeper에 몇 초 동안 저장할지 지정합니다.

<div id="shared_merge_tree_enable_automatic_empty_partitions_cleanup">
  ## shared\_merge\_tree\_enable\_automatic\_empty\_partitions\_cleanup
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.2"},{"label": "1"},{"label": "기본적으로 활성화"}]}, {"id": "row-2","items": [{"label": "25.9"},{"label": "0"},{"label": "새로운 설정"}]}]} />

빈 파티션의 Keeper 항목 정리를 활성화합니다.

<div id="shared_merge_tree_enable_coordinated_merges">
  ## shared\_merge\_tree\_enable\_coordinated\_merges
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1"},{"label": "기본적으로 조정된 머지 사용"}]}, {"id": "row-2","items": [{"label": "25.5"},{"label": "0"},{"label": "새로운 설정"}]}]} />

조정된 머지 전략을 사용하도록 설정합니다

<div id="shared_merge_tree_enable_keeper_parts_extra_data">
  ## shared\_merge\_tree\_enable\_keeper\_parts\_extra\_data
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1"},{"label": "기본적으로 조정된 머지를 활성화합니다"}]}, {"id": "row-2","items": [{"label": "25.3"},{"label": "0"},{"label": "새로운 설정"}]}]} />

가상 파트에 속성을 기록하고 Keeper에 블록을 커밋하도록 활성화합니다

<div id="shared_merge_tree_enable_outdated_parts_check">
  ## shared\_merge\_tree\_enable\_outdated\_parts\_check
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "Cloud sync"}]}]} />

오래된 파트 검사를 활성화합니다. ClickHouse Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_idle_parts_update_seconds">
  ## shared\_merge\_tree\_idle\_parts\_update\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="3600" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "3600"},{"label": "Cloud sync"}]}]} />

shared merge tree에서 ZooKeeper
watch에 의해 트리거되지 않는 파트 업데이트의 초 단위 인터벌입니다. ClickHouse Cloud에서만
사용할 수 있습니다.

<div id="shared_merge_tree_inactive_replica_cutoff_seconds">
  ## shared\_merge\_tree\_inactive\_replica\_cutoff\_seconds
</div>

<SettingsInfoBlock type="Seconds" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "비활성 레플리카를 백그라운드 정리 작업에서 얼마나 오래 고려할지 제어하는 새로운 설정입니다 (0은 ZooKeeper 세션 타임아웃 2회를 의미합니다)"}]}]} />

백그라운드 정리 작업(`OutdatedPartsQuorumThread`)에서 비활성 레플리카를 계속 고려하는 기간을 지정합니다:
레플리카가 이 값보다 짧은 시간 동안 비활성 상태였다면,
오래된 파트의 제거와 완료된 뮤테이션의 정리를 계속 지연시킵니다. 값이 0이면
기본값인 ZooKeeper 세션 타임아웃 2회를 사용합니다.
ClickHouse Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_initial_parts_update_backoff_ms">
  ## shared\_merge\_tree\_initial\_parts\_update\_backoff\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="50" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "50"},{"label": "새로운 설정"}]}]} />

파트 업데이트의 초기 백오프입니다. ClickHouse Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_interserver_http_connection_timeout_ms">
  ## shared\_merge\_tree\_interserver\_http\_connection\_timeout\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="100" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "100"},{"label": "새로운 설정"}]}]} />

interserver HTTP connection의 시간 초과를 설정합니다. ClickHouse Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_interserver_http_timeout_ms">
  ## shared\_merge\_tree\_interserver\_http\_timeout\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="10000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "10000"},{"label": "Cloud sync"}]}]} />

interserver HTTP 통신의 시간 제한입니다. ClickHouse
Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_leader_update_period_random_add_seconds">
  ## shared\_merge\_tree\_leader\_update\_period\_random\_add\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "10"},{"label": "Cloud sync"}]}]} />

thundering herd 효과를 방지하기 위해
shared\_merge\_tree\_leader\_update\_period에 0초에서 x초 사이의
균등 분포 값을 추가합니다. ClickHouse Cloud에서만 사용할 수
있습니다.

<div id="shared_merge_tree_leader_update_period_seconds">
  ## shared\_merge\_tree\_leader\_update\_period\_seconds
</div>

<SettingsInfoBlock type="UInt64" default_value="30" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "30"},{"label": "Cloud sync"}]}]} />

파트 업데이트 시 리더를 다시 확인하는 최대 주기입니다. ClickHouse Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_max_outdated_parts_to_process_at_once">
  ## shared\_merge\_tree\_max\_outdated\_parts\_to\_process\_at\_once
</div>

<SettingsInfoBlock type="UInt64" default_value="1000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1000"},{"label": "Cloud sync"}]}]} />

리더가 한 번의 HTTP 요청에서 제거 대상으로 확인하려고 시도하는 오래된 파트의 최대 개수입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_max_parts_update_backoff_ms">
  ## shared\_merge\_tree\_max\_parts\_update\_backoff\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="5000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "5000"},{"label": "새로운 설정"}]}]} />

파트 업데이트의 최대 백오프 시간입니다. ClickHouse Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_max_parts_update_leaders_in_total">
  ## shared\_merge\_tree\_max\_parts\_update\_leaders\_in\_total
</div>

<SettingsInfoBlock type="UInt64" default_value="6" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "6"},{"label": "Cloud sync"}]}]} />

파트 업데이트 리더의 최대 수입니다. ClickHouse Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_max_parts_update_leaders_per_az">
  ## shared\_merge\_tree\_max\_parts\_update\_leaders\_per\_az
</div>

<SettingsInfoBlock type="UInt64" default_value="2" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "2"},{"label": "Cloud sync"}]}]} />

parts update leaders의 최대 수입니다. ClickHouse Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_max_replicas_for_parts_deletion">
  ## shared\_merge\_tree\_max\_replicas\_for\_parts\_deletion
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "10"},{"label": "Cloud sync"}]}]} />

파트 삭제(killer thread)에 참여하는 최대 레플리카 수입니다. ClickHouse Cloud에서만
사용할 수 있습니다.

<div id="shared_merge_tree_max_replicas_to_merge_parts_for_each_parts_range">
  ## shared\_merge\_tree\_max\_replicas\_to\_merge\_parts\_for\_each\_parts\_range
</div>

<SettingsInfoBlock type="UInt64" default_value="5" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "5"},{"label": "Cloud sync"}]}]} />

잠재적으로 충돌할 수 있는 머지를 할당하려고 시도하는 최대 레플리카 수입니다(머지 할당에서 불필요한 충돌을 방지하는 데 도움이 됩니다). 0은 비활성화를 의미합니다. ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_max_suspicious_broken_parts">
  ## shared\_merge\_tree\_max\_suspicious\_broken\_parts
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "0"},{"label": "SMT의 손상된 파트 최대 수입니다. 이 값을 초과하면 자동 detach가 거부됩니다."}]}]} />

SMT의 손상된 파트 최대 수입니다. 이 값을 초과하면 자동 detach가 거부됩니다.

<div id="shared_merge_tree_max_suspicious_broken_parts_bytes">
  ## shared\_merge\_tree\_max\_suspicious\_broken\_parts\_bytes
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.2"},{"label": "0"},{"label": "SMT의 모든 손상된 파트의 최대 크기입니다. 이 값을 초과하면 자동 detach를 허용하지 않습니다."}]}]} />

SMT의 모든 손상된 파트의 최대 크기입니다. 이 값을 초과하면 자동 detach를 허용하지 않습니다.

<div id="shared_merge_tree_memo_ids_remove_timeout_seconds">
  ## shared\_merge\_tree\_memo\_ids\_remove\_timeout\_seconds
</div>

<SettingsInfoBlock type="Int64" default_value="1800" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1800"},{"label": "Cloud sync"}]}]} />

삽입 재시도 시 잘못된 동작을 방지하기 위해 삽입 메모이제이션 ID를 저장하는 기간입니다.
ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_merge_coordinator_distribution_algorithm">
  ## shared\_merge\_tree\_merge\_coordinator\_distribution\_algorithm
</div>

<SettingsInfoBlock type="MergeCoordinatorDistributionAlgorithm" default_value="water_filling" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "water_filling"},{"label": "머지 코디네이터가 레플리카 간 머지를 분배할 때 사용할 알고리즘을 제어하는 새로운 설정"}]}]} />

머지 코디네이터 스레드가 레플리카 간 머지를 분배할 때 사용할 알고리즘입니다

<div id="shared_merge_tree_merge_coordinator_election_check_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_election\_check\_period\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="30000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "30000"},{"label": "새로운 설정"}]}]} />

머지 코디네이터 선출 스레드의 실행 간격

<div id="shared_merge_tree_merge_coordinator_factor">
  ## shared\_merge\_tree\_merge\_coordinator\_factor
</div>

<SettingsInfoBlock type="Float" default_value="1.1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "1.100000023841858"},{"label": "새로운 설정"}]}, {"id": "row-2","items": [{"label": "25.10"},{"label": "1.100000023841858"},{"label": "부하 후 coordinator sleep 시간 감소"}]}]} />

coordinator thread 지연 시간의 변경 계수

<div id="shared_merge_tree_merge_coordinator_fetch_fresh_metadata_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_fetch\_fresh\_metadata\_period\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="10000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "10000"},{"label": "새로운 설정"}]}]} />

머지 코디네이터가 최신 메타데이터를 가져오기 위해 ZooKeeper와 동기화하는 주기

<div id="shared_merge_tree_merge_coordinator_max_merge_request_size">
  ## shared\_merge\_tree\_merge\_coordinator\_max\_merge\_request\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="20" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "20"},{"label": "새로운 설정"}]}]} />

coordinator가 한 번에 MergerMutator에 요청할 수 있는 머지 수

<div id="shared_merge_tree_merge_coordinator_max_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_max\_period\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="10000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "10000"},{"label": "새로운 설정"}]}]} />

머지 코디네이터 스레드 실행 간 최대 시간

<div id="shared_merge_tree_merge_coordinator_merges_prepare_count">
  ## shared\_merge\_tree\_merge\_coordinator\_merges\_prepare\_count
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "auto"},{"label": "설정을 auto로 지정: 레플리카당 최대 머지 작업 수 * 활성 레플리카 수"}]}, {"id": "row-2","items": [{"label": "25.5"},{"label": "100"},{"label": "새로운 설정"}]}]} />

coordinator가 준비하여 worker들에 분배할 머지 항목 수입니다.
'auto'로 설정하면 단일 레플리카에서 허용되는 최대 머지 작업 수에 활성 레플리카 수를 곱한 값과 같습니다.

<div id="shared_merge_tree_merge_coordinator_min_period_ms">
  ## shared\_merge\_tree\_merge\_coordinator\_min\_period\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "1"},{"label": "새로운 설정"}]}]} />

머지 코디네이터 스레드 실행 간 최소 시간

<div id="shared_merge_tree_merge_worker_fast_timeout_ms">
  ## shared\_merge\_tree\_merge\_worker\_fast\_timeout\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="100" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "100"},{"label": "새로운 설정"}]}]} />

즉시 작업 후 상태를 업데이트해야 할 때 머지 작업자 스레드가 사용하는 타임아웃

<div id="shared_merge_tree_merge_worker_regular_timeout_ms">
  ## shared\_merge\_tree\_merge\_worker\_regular\_timeout\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="10000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "10000"},{"label": "새로운 설정"}]}]} />

머지 작업자 스레드의 실행 간격

<div id="shared_merge_tree_outdated_parts_group_size">
  ## shared\_merge\_tree\_outdated\_parts\_group\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="2" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.9"},{"label": "2"},{"label": "새로운 설정"}]}]} />

오래된 파트 정리 시 동일한 rendezvous hash 그룹에 속하는 레플리카 수입니다.
ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_partitions_hint_ratio_to_reload_merge_pred_for_mutations">
  ## shared\_merge\_tree\_partitions\_hint\_ratio\_to\_reload\_merge\_pred\_for\_mutations
</div>

<SettingsInfoBlock type="Float" default_value="0.5" />

`<candidate
partitions for mutations only (partitions that cannot be merged)>/<candidate
partitions for mutations>` 비율이 이 설정보다 높으면, 머지/뮤테이션 선택 작업에서 머지 프레디케이트를 다시 로드합니다. ClickHouse Cloud에서만
사용할 수 있습니다

<div id="shared_merge_tree_parts_load_batch_size">
  ## shared\_merge\_tree\_parts\_load\_batch\_size
</div>

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

한 번에 스케줄링할 fetch 파트 메타데이터 작업 수입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_postpone_next_merge_for_locally_merged_parts_ms">
  ## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_ms
</div>

<SettingsInfoBlock type="UInt64" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "Cloud sync"}]}]} />

이 파트를 포함하는 새 머지를 시작하지 않고 로컬에서 병합된 파트를 유지하는 시간입니다.
다른 레플리카가 이 파트를 가져와 이 머지를 시작할 수 있도록 합니다.
ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_postpone_next_merge_for_locally_merged_parts_rows_threshold">
  ## shared\_merge\_tree\_postpone\_next\_merge\_for\_locally\_merged\_parts\_rows\_threshold
</div>

<SettingsInfoBlock type="UInt64" default_value="1000000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1000000"},{"label": "Cloud sync"}]}]} />

로컬에서 파트를 머지한 직후 다음 머지를 할당하지 않도록 연기하는 파트의 최소 크기(행 수)입니다. ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_range_for_merge_window_size">
  ## shared\_merge\_tree\_range\_for\_merge\_window\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "10"},{"label": "Cloud sync"}]}]} />

레플리카 간에 머지 할당을 분산하는 데 사용되는 윈도우 크기(블록 번호 단위)입니다.
같은 윈도우 내의 파트는 동일한 레플리카에 할당됩니다.
ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_read_virtual_parts_from_leader">
  ## shared\_merge\_tree\_read\_virtual\_parts\_from\_leader
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "Cloud sync"}]}]} />

가능한 경우 리더에서 가상 파트를 읽습니다. ClickHouse
Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_replica_set_max_lifetime_seconds">
  ## shared\_merge\_tree\_replica\_set\_max\_lifetime\_seconds
</div>

<SettingsInfoBlock type="Seconds" default_value="1800" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "1800"},{"label": "기본 레플리카 세트 백그라운드 업데이트 인터벌을 30분으로 늘림"}]}, {"id": "row-2","items": [{"label": "26.2"},{"label": "300"},{"label": "새로운 설정"}]}]} />

레플리카가 백그라운드에서 레플리카 세트를 업데이트하려고 시도하는 주기입니다. 다음 실행 시점에는 \[0, value]초 범위에서
균등하게 지터가 적용됩니다. 예외적으로 value = 0은 이 규칙을 따르지 않으며,
구현상 최소 200ms가 적용되므로 다음 실행 시점에는 \[0, 200]ms 범위에서 지터가 적용됩니다.

<div id="shared_merge_tree_try_fetch_part_in_memory_data_from_replicas">
  ## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "다른 레플리카에서 파트의 인메모리 데이터를 가져오기 위한 새로운 설정"}]}]} />

활성화되면 모든 레플리카는 해당 데이터가 이미 있는 다른 레플리카에서 파트의 인메모리 데이터(프라이머리 키, 파티션 정보 등)를 가져오려고 시도합니다.

<div id="shared_merge_tree_try_fetch_part_in_memory_data_from_replicas_on_startup">
  ## shared\_merge\_tree\_try\_fetch\_part\_in\_memory\_data\_from\_replicas\_on\_startup
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "시작 시 SMT가 S3 대신 레플리카에서 파트 데이터를 다운로드할 수 있게 하는 새로운 설정"}]}]} />

활성화되면 모든 레플리카는 시작 시 이미 해당 데이터가 있는 다른 레플리카로부터 파트의 인메모리 데이터(프라이머리 키, 파티션 정보 등)를 가져오려고 시도합니다.

<div id="shared_merge_tree_update_replica_flags_delay_ms">
  ## shared\_merge\_tree\_update\_replica\_flags\_delay\_ms
</div>

<SettingsInfoBlock type="Milliseconds" default_value="30000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "30000"},{"label": "새로운 설정"}]}]} />

레플리카가 백그라운드 스케줄에 따라 플래그를 다시 로드하려고 시도하는 간격입니다.

<div id="shared_merge_tree_use_metadata_hints_cache">
  ## shared\_merge\_tree\_use\_metadata\_hints\_cache
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1"},{"label": "Cloud sync"}]}]} />

다른 레플리카의 인메모리
캐시에서 FS 캐시 힌트를 요청할 수 있도록 합니다. ClickHouse Cloud에서만
사용할 수 있습니다.

<div id="shared_merge_tree_use_outdated_parts_compact_format">
  ## shared\_merge\_tree\_use\_outdated\_parts\_compact\_format
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.9"},{"label": "1"},{"label": "기본적으로 오래된 파트 v3를 활성화합니다"}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "0"},{"label": "Cloud sync"}]}]} />

오래된 파트에 compact 포맷을 사용합니다: Keeper의 부하를 줄이고
오래된 파트 처리를 개선합니다. ClickHouse Cloud에서만 사용할 수 있습니다

<div id="shared_merge_tree_use_too_many_parts_count_from_virtual_parts">
  ## shared\_merge\_tree\_use\_too\_many\_parts\_count\_from\_virtual\_parts
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "Cloud sync"}]}]} />

활성화하면 Too many parts 카운터는 로컬 레플리카 상태가 아니라 Keeper의 공유 데이터를 사용합니다. ClickHouse Cloud에서만 사용할 수 있습니다.

<div id="shared_merge_tree_use_zookeeper_connection_pool">
  ## shared\_merge\_tree\_use\_zookeeper\_connection\_pool
</div>

<SettingsInfoBlock type="Bool" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.3"},{"label": "0"},{"label": "새로운 설정"}]}]} />

활성화하면 SharedMergeTree는 서버 수준의 ZooKeeper 세션 풀 중 하나를 사용합니다.

<div id="shared_merge_tree_virtual_parts_discovery_batch">
  ## shared\_merge\_tree\_virtual\_parts\_discovery\_batch
</div>

<SettingsInfoBlock type="UInt64" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "1"},{"label": "새로운 설정"}]}]} />

하나의 배치에 패킹할 파티션 디스커버리 수

<div id="shared_merge_tree_virtual_parts_partition_atomic_discovery">
  ## shared\_merge\_tree\_virtual\_parts\_partition\_atomic\_discovery
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "1"},{"label": "새로운 설정"}]}]} />

SMT가 추가 데이터 fetch와 watch 설정을 수행하면서 가상 파트 파티션을 원자적으로 디스커버리할지 여부입니다.