distributed_cache_* 세션 설정
distributed_cache_* 세션 설정
이 설정들은 ClickHouse Cloud의 분산 캐시(distributed cache) 연결, 타임아웃, 재시도, 읽기/쓰기 동작을 제어해요. 이 설정은 모두 ClickHouse Cloud에서만 효과가 있어요. ClickHouse 소스 코드에서 자동으로 생성된 세션 설정 문서예요.
출처: 문서
본문
이 설정들은 system.settings에서 사용할 수 있으며 소스 코드에서 자동으로 생성돼요.
distributed_cache_alignment
ClickHouse Cloud에서만 효과가 있어요. 테스트용 설정이며 변경하지 마세요.
distributed_cache_bypass_connection_pool
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시 연결 풀을 우회하는 것을 허용해요.
distributed_cache_client_id
ClickHouse Cloud에서만 효과가 있어요. CI 테스트에만 사용되는 설정이에요. 비어 있지 않으면 이 쿼리의 요청에 대해 레지스트리로 구성된 분산 캐시 클라이언트 id를 재정의해요. 테스트가 같은 데이터를 같은 클라이언트 id에 유지하면서 제한된 클라이언트 id 집합에 데이터를 분산시킬 수 있게 해줘요. 분산 캐시 클라이언트 설정에 ci_mode가 활성화되어 있어야 해요. 활성화되지 않으면(프로덕션에서의 기본값) 분산 캐시를 통해 읽기나 쓰기를 라우팅하는 쿼리는 구성된 클라이언트 id로 조용히 대체되는 대신 SUPPORT_IS_DISABLED로 실패해요. 분산 캐시에 도달하지 않는 쿼리는 영향을 받지 않으므로 그 값은 무시돼요.
distributed_cache_connect_backoff_max_ms
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시 연결 생성의 최대 백오프(밀리초)예요.
distributed_cache_connect_backoff_min_ms
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시 연결 생성의 최소 백오프(밀리초)예요.
distributed_cache_connect_max_tries
ClickHouse Cloud에서만 효과가 있어요. 실패 시 분산 캐시에 연결하려는 시도 횟수예요.
distributed_cache_connect_timeout_ms
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시 서버에 연결할 때의 연결 타임아웃이에요.
distributed_cache_credentials_refresh_period_seconds
ClickHouse Cloud에서만 효과가 있어요. 자격 증명 갱신 주기예요.
distributed_cache_data_packet_ack_window
ClickHouse Cloud에서만 효과가 있어요. 단일 분산 캐시 읽기 요청에서 DataPacket 시퀀스에 대한 ACK를 보내는 창(window)이에요.
distributed_cache_discard_connection_if_unread_data
ClickHouse Cloud에서만 효과가 있어요. 읽지 않은 데이터가 있으면 연결을 버려요.
distributed_cache_fetch_metrics_only_from_current_az
ClickHouse Cloud에서만 효과가 있어요. system.distributed_cache_metrics, system.distributed_cache_events에서 현재 가용 영역의 메트릭만 가져와요.
distributed_cache_file_cache_name
ClickHouse Cloud에서만 효과가 있어요. CI 테스트에만 사용되는 설정이에요. 분산 캐시에 사용할 파일 시스템 캐시 이름이에요.
distributed_cache_log_mode
ClickHouse Cloud에서만 효과가 있어요. system.distributed_cache_log에 기록하는 모드예요.
distributed_cache_max_unacked_inflight_packets
ClickHouse Cloud에서만 효과가 있어요. 단일 분산 캐시 읽기 요청에서 승인되지 않은(unacknowledged) 진행 중(in-flight) 패킷의 최대 수예요.
distributed_cache_min_bytes_for_seek
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시에서 seek을 수행하기 위한 최소 바이트 수예요.
distributed_cache_min_inflight_bytes_to_discard_connection_on_seek
ClickHouse Cloud에서만 효과가 있어요. 열린 분산 캐시 스트림의 현재 위치에서 벗어나 seek할 때, 읽기 범위 id 메커니즘을 통해 연결을 재사용하려면 버려야 할 진행 중 바이트 수가 이 값을 초과하면 연결을 끊고 새 연결을 엽니다. seek가 빈번할 때 많은 사용되지 않은 데이터를 비우는 것을 피해줘요. 0은 이것을 비활성화하고 항상 연결을 재사용해요.
distributed_cache_pool_behaviour_on_limit
ClickHouse Cloud에서만 효과가 있어요. 풀 한도에 도달했을 때 분산 캐시 연결의 동작을 식별해요.
distributed_cache_prefer_bigger_buffer_size
ClickHouse Cloud에서만 효과가 있어요. filesystem_cache_prefer_bigger_buffer_size와 같지만 분산 캐시용이에요.
distributed_cache_read_only_from_current_az
ClickHouse Cloud에서만 효과가 있어요. 현재 가용 영역에서만 읽도록 허용해요. 비활성화하면 모든 가용 영역의 모든 캐시 서버에서 읽어요.
distributed_cache_read_request_max_tries
ClickHouse Cloud에서만 효과가 있어요. 실패 시 분산 캐시 읽기 요청을 시도하는 횟수예요.
distributed_cache_receive_response_wait_milliseconds
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시로부터 요청에 대한 데이터를 받기 위해 기다리는 시간(밀리초)이에요.
distributed_cache_receive_timeout_milliseconds
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시로부터 어떤 종류의 응답이라도 받기 위해 기다리는 시간(밀리초)이에요.
Cloud 기본값: 20000.
distributed_cache_receive_timeout_ms
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시 서버로부터 데이터를 받는 타임아웃(밀리초)이에요. 이 간격 내에 바이트가 수신되지 않으면 예외가 발생해요.
distributed_cache_registry_show_certificate_and_signature
ClickHouse Cloud에서만 효과가 있어요. system.distributed_cache_registry 테이블에 certificate와 signature 열을 표시해요. 기본적으로 이 열은 출력을 간결하게 유지하기 위해 비어 있으며, 이 설정을 활성화해 검사할 수 있어요.
distributed_cache_send_timeout_ms
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시 서버에 데이터를 보내는 타임아웃(밀리초)이에요. 클라이언트가 보낼 데이터가 있지만 이 간격 내에 바이트를 보낼 수 없으면 예외가 발생해요.
distributed_cache_tcp_keep_alive_timeout_ms
ClickHouse Cloud에서만 효과가 있어요. TCP가 keepalive 프로브를 보내기 시작하기 전에 분산 캐시 서버 연결이 유휴 상태로 유지되어야 하는 시간(밀리초)이에요.
distributed_cache_throw_on_error
ClickHouse Cloud에서만 효과가 있어요. 분산 캐시와의 통신 중 발생한 예외나 분산 캐시에서 받은 예외를 다시 던져요. 그렇지 않으면 오류 시 분산 캐시를 건너뛰는 것으로 대체돼요.
distributed_cache_use_clients_cache_for_read
ClickHouse Cloud에서만 효과가 있어요. 읽기 요청에 클라이언트 캐시를 사용해요.
distributed_cache_wait_connection_from_pool_milliseconds
ClickHouse Cloud에서만 효과가 있어요. distributed_cache_pool_behaviour_on_limit이 wait일 때 연결 풀로부터 연결을 받기 위해 기다리는 시간(밀리초)이에요.
distributed_cache_write_request_max_tries
ClickHouse Cloud에서만 효과가 있어요. 실패 시 분산 캐시 쓰기 요청을 시도하는 횟수예요.