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

# distributed_cache_* 세션 설정

> distributed_cache_* 생성 그룹에 속한 ClickHouse 세션 설정입니다.

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>;
};

export const CloudOnlyBadge = () => {
  return <div className="cloudBadge">
            <div className="cloudIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path fillRule="evenodd" clipRule="evenodd" d="M5.33395 12.6667H12.3739C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00004 12.3739 8.00004H12.0839V7.33337C12.0839 5.12671 10.2906 3.33337 8.08395 3.33337C6.09928 3.33337 4.45395 4.78537 4.14195 6.68204C2.55728 6.76271 1.29395 8.06204 1.29395 9.66671C1.29395 11.3234 2.63728 12.6667 4.29395 12.6667H5.33395Z" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'ClickHouse Cloud 전용'}
        </div>;
};

이러한 설정은 [system.settings](/docs/ko/reference/system-tables/settings)에서 확인할 수 있으며 [소스 코드](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp)에서 자동 생성됩니다.

<div id="distributed_cache_alignment">
  ## distributed\_cache\_alignment
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.7"},{"label": "0"},{"label": "distributed_cache_read_alignment에서 이름이 변경됨"}]}]} />

ClickHouse Cloud에서만 적용됩니다. 테스트용 설정이므로 변경하지 마십시오

<div id="distributed_cache_bypass_connection_pool">
  ## distributed\_cache\_bypass\_connection\_pool
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "0"},{"label": "ClickHouse Cloud용 설정"}]}]} />

ClickHouse Cloud에서만 효과가 있습니다. Distributed Cache 연결 풀 우회를 허용합니다

<div id="distributed_cache_connect_backoff_max_ms">
  ## distributed\_cache\_connect\_backoff\_max\_ms
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 적용됩니다. Distributed Cache 연결 생성 시 최대 백오프 시간을 밀리초 단위로 지정합니다.

<div id="distributed_cache_connect_backoff_min_ms">
  ## distributed\_cache\_connect\_backoff\_min\_ms
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 적용됩니다. Distributed Cache 연결 생성 시 최소 백오프 시간(밀리초)입니다.

<div id="distributed_cache_connect_max_tries">
  ## distributed\_cache\_connect\_max\_tries
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "5"},{"label": "설정 값 변경"}]}, {"id": "row-2","items": [{"label": "25.1"},{"label": "20"},{"label": "Cloud 전용"}]}, {"id": "row-3","items": [{"label": "24.10"},{"label": "20"},{"label": "ClickHouse Cloud용 설정"}]}]} />

ClickHouse Cloud에서만 적용됩니다. Distributed Cache 연결에 실패했을 때 다시 연결을 시도하는 횟수입니다.

<div id="distributed_cache_connect_timeout_ms">
  ## distributed\_cache\_connect\_timeout\_ms
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 효과가 있습니다. Distributed Cache server에 연결할 때의 연결 타임아웃입니다.

<div id="distributed_cache_credentials_refresh_period_seconds">
  ## distributed\_cache\_credentials\_refresh\_period\_seconds
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.6"},{"label": "5"},{"label": "새 비공개 설정"}]}]} />

ClickHouse Cloud에서만 적용됩니다. 자격 증명 갱신 주기입니다.

<div id="distributed_cache_data_packet_ack_window">
  ## distributed\_cache\_data\_packet\_ack\_window
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "5"},{"label": "ClickHouse Cloud용 설정"}]}]} />

ClickHouse Cloud에서만 적용됩니다. 단일 Distributed Cache 읽기 요청에서 DataPacket 시퀀스에 대한 ACK를 전송할 때 사용하는 윈도우입니다.

<div id="distributed_cache_discard_connection_if_unread_data">
  ## distributed\_cache\_discard\_connection\_if\_unread\_data
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 효과가 있습니다. 일부 데이터를 읽지 않은 상태이면 연결을 폐기합니다.

<div id="distributed_cache_fetch_metrics_only_from_current_az">
  ## distributed\_cache\_fetch\_metrics\_only\_from\_current\_az
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "1"},{"label": "ClickHouse Cloud용 설정"}]}]} />

이 설정은 ClickHouse Cloud에서만 적용됩니다. system.distributed\_cache\_metrics, system.distributed\_cache\_events에서 현재 가용 영역의 메트릭만 가져옵니다

<div id="distributed_cache_file_cache_name">
  ## distributed\_cache\_file\_cache\_name
</div>

<CloudOnlyBadge />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": ""},{"label": "새 설정입니다."}]}]} />

ClickHouse Cloud에서만 적용됩니다. CI 테스트에서만 사용하는 설정으로, Distributed Cache에서 사용할 파일 시스템 캐시 이름을 지정합니다.

<div id="distributed_cache_log_mode">
  ## distributed\_cache\_log\_mode
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="DistributedCacheLogMode" default_value="on_error" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "on_error"},{"label": "ClickHouse Cloud용 설정"}]}]} />

ClickHouse Cloud에서만 적용됩니다. system.distributed\_cache\_log에 기록할 때 사용하는 모드입니다.

<div id="distributed_cache_max_unacked_inflight_packets">
  ## distributed\_cache\_max\_unacked\_inflight\_packets
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "10"},{"label": "ClickHouse Cloud용 설정"}]}]} />

이 설정은 ClickHouse Cloud에서만 적용됩니다. 단일 Distributed Cache 읽기 요청에서 확인되지 않은 전송 중 packet의 최대 개수입니다.

<div id="distributed_cache_min_bytes_for_seek">
  ## distributed\_cache\_min\_bytes\_for\_seek
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "0"},{"label": "새 비공개 설정."}]}]} />

ClickHouse Cloud에서만 적용됩니다. Distributed Cache에서 seek를 수행할 최소 바이트 수입니다.

<div id="distributed_cache_pool_behaviour_on_limit">
  ## distributed\_cache\_pool\_behaviour\_on\_limit
</div>

<CloudOnlyBadge />

<SettingsInfoBlock type="DistributedCachePoolBehaviourOnLimit" default_value="wait" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "wait"},{"label": "Cloud 전용"}]}, {"id": "row-2","items": [{"label": "24.10"},{"label": "allocate_bypassing_pool"},{"label": "ClickHouse Cloud용 설정"}]}]} />

ClickHouse Cloud에서만 적용됩니다. 풀 한도에 도달했을 때 Distributed Cache 연결의 동작을 지정합니다

<div id="distributed_cache_prefer_bigger_buffer_size">
  ## distributed\_cache\_prefer\_bigger\_buffer\_size
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.10"},{"label": "0"},{"label": "새 설정입니다."}]}]} />

이 설정은 ClickHouse Cloud에서만 적용됩니다. `filesystem_cache_prefer_bigger_buffer_size`와 동일하지만 Distributed Cache에 적용됩니다.

<div id="distributed_cache_read_only_from_current_az">
  ## distributed\_cache\_read\_only\_from\_current\_az
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 적용됩니다. 현재 가용 영역에서만 읽기를 허용합니다. 비활성화하면 모든 가용 영역의 모든 캐시 서버에서 읽습니다.

<div id="distributed_cache_read_request_max_tries">
  ## distributed\_cache\_read\_request\_max\_tries
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.8"},{"label": "10"},{"label": "설정 값 변경"}]}, {"id": "row-2","items": [{"label": "25.4"},{"label": "20"},{"label": "새로운 설정"}]}]} />

ClickHouse Cloud에서만 적용됩니다. Distributed Cache 읽기 요청이 실패했을 때 다시 시도하는 횟수입니다.

<div id="distributed_cache_receive_response_wait_milliseconds">
  ## distributed\_cache\_receive\_response\_wait\_milliseconds
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "60000"},{"label": "ClickHouse Cloud용 설정"}]}]} />

ClickHouse Cloud에서만 적용됩니다. Distributed Cache에서 요청 데이터를 수신할 때까지 대기하는 시간을 밀리초 단위로 설정합니다.

<div id="distributed_cache_receive_timeout_milliseconds">
  ## distributed\_cache\_receive\_timeout\_milliseconds
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "10000"},{"label": "ClickHouse Cloud용 설정"}]}]} />

ClickHouse Cloud에서만 적용됩니다. Distributed Cache에서 어떤 종류의 응답이든 수신할 때까지 대기하는 시간(밀리초)입니다.

Cloud 기본값: `20000`.

<div id="distributed_cache_receive_timeout_ms">
  ## distributed\_cache\_receive\_timeout\_ms
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 적용됩니다. Distributed Cache 서버에서 데이터를 수신할 때의 timeout을 밀리초 단위로 지정합니다. 이 시간 동안 바이트를 전혀 수신하지 못하면 예외가 발생합니다.

<div id="distributed_cache_registry_show_certificate_and_signature">
  ## distributed\_cache\_registry\_show\_certificate\_and\_signature
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "0"},{"label": "`system.distributed_cache_registry`에서 `certificate` 및 `signature` 컬럼을 표시하는 새로운 설정입니다."}]}]} />

ClickHouse Cloud에서만 적용됩니다. `system.distributed_cache_registry` 테이블에 `certificate` 및 `signature` 컬럼을 표시합니다. 기본적으로는 출력이 간결하게 유지되도록 이 컬럼들이 비어 있으며, 이를 확인하려면 이 설정을 활성화하십시오.

<div id="distributed_cache_send_timeout_ms">
  ## distributed\_cache\_send\_timeout\_ms
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 적용됩니다. distributed cache server로 데이터를 전송할 때의 timeout으로, 단위는 밀리초입니다. 클라이언트가 데이터를 전송해야 하지만 이 인터벌 동안 한 바이트도 전송하지 못하면 예외가 발생합니다.

<div id="distributed_cache_tcp_keep_alive_timeout_ms">
  ## distributed\_cache\_tcp\_keep\_alive\_timeout\_ms
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 적용됩니다. TCP가 keepalive probe 전송을 시작하기 전에 Distributed Cache server에 대한 connection이 유휴 상태로 유지되어야 하는 시간을 밀리초 단위로 나타냅니다.

<div id="distributed_cache_throw_on_error">
  ## distributed\_cache\_throw\_on\_error
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "0"},{"label": "ClickHouse Cloud용 설정"}]}]} />

이 설정은 ClickHouse Cloud에서만 적용됩니다. Distributed Cache와 통신하는 중 발생한 예외 또는 Distributed Cache로부터 받은 예외를 다시 발생시킵니다. 그렇지 않으면 오류 발생 시 Distributed Cache를 스키핑하도록 폴백합니다

<div id="distributed_cache_use_clients_cache_for_read">
  ## distributed\_cache\_use\_clients\_cache\_for\_read
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 적용됩니다. 읽기 요청에 대해 clients cache를 사용합니다.

<div id="distributed_cache_wait_connection_from_pool_milliseconds">
  ## distributed\_cache\_wait\_connection\_from\_pool\_milliseconds
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": "100"},{"label": "ClickHouse Cloud용 설정"}]}]} />

ClickHouse Cloud에서만 적용됩니다. distributed\_cache\_pool\_behaviour\_on\_limit가 wait인 경우 연결 풀에서 연결을 받을 때까지 대기하는 시간(밀리초)입니다.

<div id="distributed_cache_write_request_max_tries">
  ## distributed\_cache\_write\_request\_max\_tries
</div>

<CloudOnlyBadge />

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

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

ClickHouse Cloud에서만 적용됩니다. 실패 시 Distributed Cache 쓰기 요청을 수행하는 최대 시도 횟수입니다.