Skip to main content
이 설정은 system.settings에서 확인할 수 있으며, source로부터 자동 생성됩니다.

filesystem_cache_allow_background_download

원격 스토리지에서 읽은 데이터에 대해 파일 시스템 캐시가 백그라운드 다운로드를 큐에 추가하도록 허용합니다. 비활성화하면 다운로드는 현재 쿼리/세션의 포그라운드에서 수행됩니다.

filesystem_cache_boundary_alignment

파일 시스템 캐시 경계 정렬입니다. 이 설정은 디스크에서 읽지 않는 경우에만 적용됩니다(예: 원격 테이블 엔진/테이블 함수의 캐시에는 적용되지만, MergeTree 테이블의 저장소 구성에는 적용되지 않습니다). 값이 0이면 정렬하지 않습니다.

filesystem_cache_enable_background_download_during_fetch

ClickHouse Cloud에서만 적용됩니다. 파일 시스템 캐시에서 공간을 예약하기 위해 캐시 잠금을 획득할 때까지의 대기 시간

filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage

ClickHouse Cloud에서만 적용됩니다. 파일 시스템 캐시에서 공간을 예약하기 위해 캐시 잠금을 획득할 때까지의 대기 시간

filesystem_cache_max_download_size

단일 쿼리에서 다운로드할 수 있는 원격 파일 시스템 캐시의 최대 크기

filesystem_cache_name

stateless 테이블 엔진이나 데이터 레이크에서 사용할 파일 시스템 캐시 이름

filesystem_cache_prefer_bigger_buffer_size

파일 시스템 캐시가 활성화된 경우, 캐시 성능을 저하시키는 작은 file segment의 쓰기를 방지하기 위해 더 큰 버퍼 크기를 사용하는 것이 바람직합니다. 반면, 이 설정을 활성화하면 메모리 사용량이 증가할 수 있습니다.

filesystem_cache_reserve_space_wait_lock_timeout_milliseconds

파일 시스템 캐시에서 공간을 예약하기 위해 캐시 잠금을 획득할 때까지 대기하는 시간

filesystem_cache_segments_batch_size

읽기 버퍼가 캐시에서 한 번에 요청할 수 있는 파일 세그먼트 배치 크기의 제한입니다. 값이 너무 낮으면 캐시에 대한 요청이 과도하게 많아지고, 너무 크면 캐시에서의 eviction이 느려질 수 있습니다.

filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit

별칭: skip_download_if_exceeds_query_cache 쿼리 캐시 크기 제한을 초과하면 원격 파일 시스템에서의 다운로드를 건너뜁니다

filesystem_cache_verbose_logging

파일 시스템 캐시 버퍼를 리필할 때마다 TEST 수준의 로그 메시지(읽기 상태, 남은 읽기 크기, 읽은 바이트 수)를 출력합니다. 디버깅 용도로만 사용하십시오. 메시지는 읽기마다 한 번 포맷되므로, 작은 캐시 읽기를 많이 수행하는 쿼리에서 이 설정을 활성화하면 로깅 오버헤드가 크게 증가합니다. 메시지는 어차피 로그 레벨이 test일 때만 표시됩니다(send_logs_level 참조).

filesystem_cache_wait_for_concurrent_download_timeout_milliseconds

동시 쿼리가 파일 시스템 캐시에 다운로드 중인 파일 세그먼트를 대기하는 최대 시간입니다. 시간 초과에 도달하면 읽기 작업은 해당 범위에서 파일 시스템 캐시를 우회하고 원격 스토리지에서 직접 읽으며, 동시 다운로드는 계속 캐시를 채웁니다. 값 0은 전혀 대기하지 않음을 의미합니다. 필요한 범위가 아직 다운로드되지 않은 경우 즉시 캐시를 우회합니다. 이 값을 낮추면 원격 스토리지에 대한 추가 요청이 발생하는 대신, 다른 쿼리의 다운로드 속도를 기다리게 되는 캐시 적중 읽기의 테일 지연 시간을 제한할 수 있습니다.
마지막 수정일 2026년 8월 14일