Skip to main content
이러한 설정은 system.settings에서 확인할 수 있으며, 소스 코드를 바탕으로 자동 생성됩니다.

distributed_background_insert_batch

별칭: distributed_directory_monitor_batch_inserts 삽입된 데이터를 배치로 전송할지 여부를 설정합니다. 배치 전송이 활성화되면 분산 테이블 엔진은 삽입된 데이터의 여러 파일을 각각 따로 전송하는 대신 한 번에 전송하려고 시도합니다. 배치 전송을 사용하면 server 및 네트워크 리소스를 더 효율적으로 활용할 수 있어 cluster 성능이 향상됩니다. 가능한 값:
  • 1 — 활성화됨.
  • 0 — 비활성화됨.

distributed_background_insert_max_sleep_time_ms

별칭: distributed_directory_monitor_max_sleep_time_ms 분산 테이블 엔진이 데이터를 전송할 때의 최대 인터벌입니다. distributed_background_insert_sleep_time_ms 설정에 지정된 인터벌이 지수적으로 증가하는 최대치를 제한합니다. 가능한 값:
  • 밀리초 단위의 양의 정수.

distributed_background_insert_sleep_time_ms

별칭: distributed_directory_monitor_sleep_time_ms 분산 테이블 엔진이 데이터를 전송할 때 사용하는 기본 인터벌입니다. 실제 인터벌은 오류가 발생하면 지수적으로 증가합니다. 가능한 값:
  • 밀리초 단위의 양의 정수.

distributed_background_insert_split_batch_on_failure

별칭: distributed_directory_monitor_split_batch_on_failure 실패 시 배치를 분할하는 기능을 활성화/비활성화합니다. 경우에 따라 특정 배치를 원격 세그먼트로 전송하는 작업이, 이후의 복잡한 파이프라인(예: GROUP BY가 포함된 MATERIALIZED VIEW)에서 Memory limit exceeded 또는 이와 유사한 오류가 발생하여 실패할 수 있습니다. 이런 경우에는 재시도해도 도움이 되지 않으며, 해당 테이블의 분산 전송이 중단될 수 있습니다. 하지만 그 배치에 포함된 파일을 하나씩 전송하면 INSERT가 성공할 수 있습니다. 따라서 이 설정을 1로 지정하면 이러한 배치에 대해서는 배칭이 비활성화됩니다(즉, 실패한 배치에 대해 distributed_background_insert_batch를 일시적으로 비활성화합니다). 가능한 값:
  • 1 — 활성화됨.
  • 0 — 비활성화됨.
이 설정은 손상된 배치에도 영향을 미칩니다(비정상적인 server(머신) 종료가 발생하고, 분산 테이블 엔진에서 fsync_after_insert/fsync_directories를 사용하지 않는 경우 이러한 배치가 생길 수 있습니다).
자동 배치 분할은 성능에 악영향을 줄 수 있으므로 이에 의존하지 마십시오.

distributed_background_insert_timeout

별칭: insert_distributed_timeout 분산 테이블에 데이터를 삽입하는 쿼리의 제한 시간입니다. 이 설정은 insert_distributed_sync가 활성화된 경우에만 사용됩니다. 값이 0이면 제한 시간이 없습니다.
마지막 수정일 2026년 7월 23일