Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

distributed_cache_* 세션 설정

이러한 설정은 system.settings에서 확인할 수 있으며 소스 코드에서 자동 생성됩니다.

distributed_cache_alignment

ClickHouse Cloud 전용
유형
UInt64
기본값
0
버전 이력
버전기본값설명
25.70distributed_cache_read_alignment에서 이름이 변경됨

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

distributed_cache_bypass_connection_pool

ClickHouse Cloud 전용
유형
Bool
기본값
0
버전 이력
버전기본값설명
24.100ClickHouse Cloud용 설정

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

distributed_cache_client_id

ClickHouse Cloud 전용
버전 이력
버전기본값설명
26.9쿼리별 distributed cache client id를 재정의하는 새로운 설정(CI 테스트 전용).
26.8쿼리별 distributed cache client id를 재정의하는 새로운 설정(CI 테스트 전용).

ClickHouse Cloud에서만 적용됩니다. CI 테스트 전용 설정으로, 비어 있지 않으면 이 쿼리의 요청에 대해 registry에 구성된 distributed cache client id를 재정의합니다. 테스트에서 제한된 client id 집합에 데이터를 분산하는 동시에 동일한 데이터가 동일한 client id에 유지되도록 합니다. distributed cache client 구성에서 ci_mode를 활성화해야 합니다. 활성화하지 않으면(기본값이며 production 환경도 이에 해당) distributed cache를 통해 읽기 또는 쓰기가 라우팅되는 쿼리는 구성된 client id로 자동 대체되는 대신 SUPPORT_IS_DISABLED 오류와 함께 실패합니다. distributed cache에 도달하지 않는 쿼리는 영향을 받지 않으므로 이 값은 무시됩니다.

distributed_cache_connect_backoff_max_ms

ClickHouse Cloud 전용
유형
UInt64
기본값
50
버전 이력
버전기본값설명
25.850새로운 설정

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

distributed_cache_connect_backoff_min_ms

ClickHouse Cloud 전용
유형
UInt64
기본값
0
버전 이력
버전기본값설명
25.80새로운 설정

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

distributed_cache_connect_max_tries

ClickHouse Cloud 전용
유형
UInt64
기본값
5
버전 이력
버전기본값설명
25.85설정 값 변경
25.120Cloud 전용
24.1020ClickHouse Cloud용 설정

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

distributed_cache_connect_timeout_ms

ClickHouse Cloud 전용
유형
UInt64
기본값
50
버전 이력
버전기본값설명
25.1050새로운 설정

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

distributed_cache_credentials_refresh_period_seconds

ClickHouse Cloud 전용
유형
UInt64
기본값
5
버전 이력
버전기본값설명
25.65새 비공개 설정

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

distributed_cache_data_packet_ack_window

ClickHouse Cloud 전용
유형
UInt64
기본값
5
버전 이력
버전기본값설명
24.105ClickHouse Cloud용 설정

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

distributed_cache_discard_connection_if_unread_data

ClickHouse Cloud 전용
유형
Bool
기본값
1
버전 이력
버전기본값설명
24.111새로운 설정
24.101새로운 설정

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

distributed_cache_fetch_metrics_only_from_current_az

ClickHouse Cloud 전용
유형
Bool
기본값
1
버전 이력
버전기본값설명
24.101ClickHouse Cloud용 설정

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

distributed_cache_file_cache_name

ClickHouse Cloud 전용
버전 이력
버전기본값설명
26.1새 설정입니다.

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

distributed_cache_log_mode

ClickHouse Cloud 전용
유형
DistributedCacheLogMode
기본값
on_error
버전 이력
버전기본값설명
24.10on_errorClickHouse Cloud용 설정

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

distributed_cache_max_unacked_inflight_packets

ClickHouse Cloud 전용
유형
UInt64
기본값
10
버전 이력
버전기본값설명
24.1010ClickHouse Cloud용 설정

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

distributed_cache_min_bytes_for_seek

ClickHouse Cloud 전용
유형
UInt64
기본값
0
버전 이력
버전기본값설명
25.10새 비공개 설정.

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

distributed_cache_min_inflight_bytes_to_discard_connection_on_seek

ClickHouse Cloud 전용
유형
UInt64
기본값
4194304
버전 이력
버전기본값설명
26.94194304seek 시 폐기해야 하는 전송 중 바이트 수가 너무 많을 경우 Distributed Cache 연결을 끊고 다시 여는 새로운 설정입니다. 기본값은 4 MiB이며, 0으로 설정하면 이전 동작(항상 읽기 범위 ID를 통해 연결 재사용)으로 돌아갑니다.
26.84194304seek 시 폐기해야 하는 전송 중 바이트 수가 너무 많을 경우 Distributed Cache 연결을 끊고 다시 여는 새로운 설정입니다. 기본값은 4 MiB이며, 0으로 설정하면 이전 동작(항상 읽기 범위 ID를 통해 연결 재사용)으로 돌아갑니다.
26.74194304seek 시 폐기해야 하는 전송 중 바이트 수가 너무 많을 경우 Distributed Cache 연결을 끊고 다시 여는 새로운 설정입니다. 기본값은 4 MiB이며, 0으로 설정하면 이전 동작(항상 읽기 범위 ID를 통해 연결 재사용)으로 돌아갑니다.

ClickHouse Cloud에서만 적용됩니다. 열린 Distributed Cache 스트림의 현재 위치에서 다른 위치로 seek할 때, 연결을 계속 재사용하기 위해(읽기 범위 ID 메커니즘을 통해) 폐기해야 하는 것으로 추정되는 전송 중 바이트 수가 이 값을 초과하면 연결을 끊고 새로 엽니다. 이렇게 하면 seek가 빈번할 때 사용되지 않는 대량의 데이터를 소진하지 않아도 됩니다. 0으로 설정하면 이 기능이 비활성화되며 항상 연결을 재사용합니다.

distributed_cache_pool_behaviour_on_limit

ClickHouse Cloud 전용
유형
DistributedCachePoolBehaviourOnLimit
기본값
wait
버전 이력
버전기본값설명
25.1waitCloud 전용
24.10allocate_bypassing_poolClickHouse Cloud용 설정

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

distributed_cache_prefer_bigger_buffer_size

ClickHouse Cloud 전용
유형
Bool
기본값
0
버전 이력
버전기본값설명
25.100새 설정입니다.

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

distributed_cache_read_only_from_current_az

ClickHouse Cloud 전용
유형
Bool
기본값
1
버전 이력
버전기본값설명
25.51새로운 설정

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

distributed_cache_read_request_max_tries

ClickHouse Cloud 전용
유형
UInt64
기본값
10
버전 이력
버전기본값설명
25.810설정 값 변경
25.420새로운 설정

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

distributed_cache_receive_response_wait_milliseconds

ClickHouse Cloud 전용
유형
UInt64
기본값
60000
버전 이력
버전기본값설명
24.1060000ClickHouse Cloud용 설정

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

distributed_cache_receive_timeout_milliseconds

ClickHouse Cloud 전용
유형
UInt64
기본값
10000
버전 이력
버전기본값설명
24.1010000ClickHouse Cloud용 설정

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

Cloud 기본값: 20000.

distributed_cache_receive_timeout_ms

ClickHouse Cloud 전용
유형
UInt64
기본값
3000
버전 이력
버전기본값설명
25.103000새로운 설정

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

distributed_cache_registry_show_certificate_and_signature

ClickHouse Cloud 전용
유형
Bool
기본값
0
버전 이력
버전기본값설명
26.60`system.distributed_cache_registry`에서 `certificate` 및 `signature` 컬럼을 표시하는 새로운 설정입니다.

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

distributed_cache_send_timeout_ms

ClickHouse Cloud 전용
유형
UInt64
기본값
3000
버전 이력
버전기본값설명
25.103000새로운 설정

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

distributed_cache_tcp_keep_alive_timeout_ms

ClickHouse Cloud 전용
유형
UInt64
기본값
2900
버전 이력
버전기본값설명
25.102900새로운 설정

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

distributed_cache_throw_on_error

ClickHouse Cloud 전용
유형
Bool
기본값
0
버전 이력
버전기본값설명
24.100ClickHouse Cloud용 설정

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

distributed_cache_use_clients_cache_for_read

ClickHouse Cloud 전용
유형
Bool
기본값
1
버전 이력
버전기본값설명
25.121새로운 설정

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

distributed_cache_wait_connection_from_pool_milliseconds

ClickHouse Cloud 전용
유형
UInt64
기본값
100
버전 이력
버전기본값설명
24.10100ClickHouse Cloud용 설정

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

distributed_cache_write_request_max_tries

ClickHouse Cloud 전용
유형
UInt64
기본값
10
버전 이력
버전기본값설명
26.410새로운 설정

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

Navigation