filesystem_cache_settings 시스템 테이블
filesystem_cache_settings 시스템 테이블
filesystem_cache_settings 시스템 테이블은 모든 파일시스템 캐시 설정에 대한 정보를 담고 있어요.
출처: 문서
본문
Description (설명)
모든 파일시스템 캐시 설정에 대한 정보를 담고 있어요.
Columns (열)
cache_name(String) — 캐시 이름.path(String) — 캐시 디렉터리 경로.max_size(UInt64) — 최대 캐시 크기.max_elements(UInt64) — 최대 캐시 요소 수, 예: 파일 세그먼트(파일시스템의 파일 수 제한).max_file_segment_size(UInt64) — 단일 파일 세그먼트의 최대 크기.boundary_alignment(UInt64) — 파일 세그먼트 정렬.reserve_granularity(UInt64) — 파일 세그먼트 다운로드를 위해 공간을 예약할 때, 다운로드 크기보다 앞에 이 바이트 이상을 예약해요(파일 세그먼트 크기로 제한). 더 거친 granularity는 예약 핫 경로에서 캐시 상태 잠금 획득 속도를 줄이는 대신, 예약되었지만 아직 다운로드되지 않은 공간을 일부 보유하게 돼요(파일 세그먼트 완료 시 회수). 값 0은 선행 예약을 비활성화해요: 공간은 요청된 만큼 정확히 예약돼요.cache_on_write_operations(UInt8) — 라이트스루 캐시(INSERT와 MERGE 시 캐시)를 활성화해요.cache_policy(String) — 캐시 축출 정책.slru_size_ratio(Float64) — SLRU 캐시 정책의 보호 요소 대 보호 관찰 요소 크기 비율.background_download_threads(UInt64) — 백그라운드 다운로드 스레드 수. 값 0은 백그라운드 다운로드를 비활성화해요.background_download_queue_size_limit(UInt64) — 백그라운드 다운로드 큐의 크기. 값 0은 백그라운드 다운로드를 비활성화해요.background_download_max_file_segment_size(UInt64) — 백그라운드 다운로드에서 다운로드할 수 있는 최대 크기.load_metadata_threads(UInt64) — 서버 시작 시 캐시 메타데이터를 로드하는 데 사용되는 최대 스레드 수.load_metadata_asynchronously(UInt8) — 서버 시작 시 메타데이터의 비동기 로드를 활성화해요.keep_free_space_size_ratio(Float64) — 캐시가 백그라운드에서 유지하려고 시도하는 여유 공간의 비율.keep_free_space_elements_ratio(Float64) — 캐시가 백그라운드에서 유지하려고 시도하는 여유 요소의 비율.keep_free_space_remove_batch(UInt64) — 여유 공간/요소 비율을 유지하는 백그라운드 스레드가 만드는 캐시 요소의 제거 배치 크기.keep_free_space_eviction_threads(UInt64) — 배경 여유 공간/요소 비율 유지를 위해 실제 파일 세그먼트 제거(파일시스템 삭제)를 수행하는 스레드 수. 단일 백그라운드 스레드가 축출 후보를 수집하고 그들의 우선순위 큐 항목을 해제하는 동안, 이 스레드들은 잠금 없는 제거를 병렬로 수행해요.invalidated_entries_cleanup_interval_ms(UInt64) — 무효화된(느리게 제거된) 우선순위 큐 항목을 정리하는 백그라운드 작업의 유휴 간격(밀리초).invalidated_entries_cleanup_threshold(UInt64) — 백그라운드 제거를 트리거하는 누적된 무효화된 우선순위 큐 항목 수.invalidated_entries_cleanup_remove_batch(UInt64) — 백그라운드 반복당 단일 쓰기 잠금 아래에서 제거되는 무효화된 우선순위 큐 항목의 최대 수.enable_filesystem_query_cache_limit(UInt8) — 쿼리 안에서 쓸 수 있는 캐시 최대 크기 제한을 활성화해요.cache_hits_threshold(UInt64) — 더 이상 사용되지 않는 설정.enable_bypass_cache_with_threshold(UInt8) — 문서화되지 않음. 사용을 권장하지 않아요.bypass_cache_threshold(UInt64) — 문서화되지 않음. 사용을 권장하지 않아요.write_cache_per_user_id_directory(UInt8) — 더 이상 사용되지 않는 설정, 무시됨. 동작은 이제 캐시 정책에 따라 자동으로 결정돼요.allow_dynamic_cache_resize(UInt8) — 파일시스템 캐시의 동적 크기 조정을 허용해요.dynamic_resize_lock_wait_ms(UInt64) — 크기 조정 시도를 건너뛰기 전에 동적 크기 조정 전용 잠금을 획득하는 제한 시간(밀리초).max_size_ratio_to_total_space(Float64) — 총 디스크 공간에 대한max_size의 비율.skip_cache_on_disk_failure(UInt8) — true이면 디스크 IO 오류 시 파일시스템 캐시 작업을 조용히 우회해요. false(기본값)이면 디스크 IO 오류가 시작 실패로 전파돼요.use_split_cache(UInt8) — 파일을 시스템/데이터로 구분하는 것을 사용해요.split_cache_ratio(Float64) — split_cache에 대한 캐시 총 크기 대 시스템 세그먼트의 비율.system_cache_extensions(String) —use_split_cache가 활성화될 때 시스템 캐시 세그먼트로 분류되는 파일 확장자의 쉼표로 구분된 목록. 변경하면 기존 캐시 항목은 이전 세그먼트 유형에 남아 시간이 지나며 자연스럽게 축출돼요. 이 설정을 변경하려면 재시작이 필요해요.overcommit_eviction_evict_step(UInt64) — 초과 커밋 축출 정책의 축출 단계(바이트). keep_free_space_*_ratio 설정에 사용돼요.check_cache_probability(Float64) — 디버그 또는 sanitizer 빌드에서만 동작해요. 모든 캐시를 살펴보고 각 캐시 요소의 상태를 확인해 캐시 정확성을 검사해요.idle_client_ttl_sec(UInt64) — 0이 아니고 캐시 정책이 클라이언트별 사용량을 추적하면, 이 초 동안 접근되지 않은 클라이언트(user_id)에 속한 모든 캐시 항목이 캐시에서 완전히 제거돼요. 클라이언트에 의한 각 접근은 타이머를 갱신해요. 기본값은 1주일이에요. 분산 캐시 서버에서 사용돼요.idle_client_check_interval_sec(UInt64) — 유휴 클라이언트 축출 작업이 실행되는 주기(초).idle_client_ttl_sec가 0이 아닐 때만 의미가 있어요. 0은 자동 값(max(1, idle_client_ttl_sec / 10))을 의미해요.idle_client_eviction_threads(UInt64) — 유휴 클라이언트의 캐시를 정리하는 데 사용되는 최대 스레드 수.idle_client_ttl_sec가 0이 아닐 때만 의미가 있어요.expose_prometheus_eviction_metrics(UInt8) — 파일시스템 캐시 축출 활동에 대한 Prometheus 메트릭(filesystem_cache_evictions_total등)을 노출해요. 기본적으로 꺼져 있어요.SYSTEM RELOAD CONFIG로 런타임에 전환할 수 있어요.expose_prometheus_eviction_metrics_per_user(UInt8) — 추가로 사용자별 축출 메트릭을 노출해요.expose_prometheus_eviction_metrics가 필요해요. 구별되는 축출 사용자 수에 따라 카디널리티가 커져요.drop_cache_threads(UInt64) —SYSTEM DROP FILESYSTEM CACHE에서 캐시 키를 병렬로 제거하는 데 사용되는 최대 스레드 수. 값 1은 제거가 쿼리 스레드 단독으로 수행됨을 의미해요.is_initialized(UInt8) — 캐시가 성공적으로 초기화되었는지 여부를 나타내요.current_size(UInt64) — 현재 캐시 크기.current_elements_num(UInt64) — 현재 캐시 요소(파일 세그먼트) 수.