backups 서버 설정

backups 서버 설정

이 페이지에서는 BACKUP 및 RESTORE 문을 실행할 때 사용되는 백업 관련 설정인 backups와 IO 스레드 풀 관련 설정인 backups_io_thread_pool_*을 설명할게요.

출처: 문서

본문

이 설정들은 ClickHouse 서버를 구성하며, ClickHouse 소스에서 자동으로 생성돼요.

backups

BACKUP 및 RESTORE 문을 실행할 때 사용되는 백업 설정이에요. 다음 설정은 하위 태그(sub-tags)로 구성할 수 있어요.

Setting Type Description Default
allow_concurrent_backups Bool 같은 호스트에서 여러 백업 작업을 동시에 실행할 수 있는지 결정해요. true
allow_concurrent_restores Bool 같은 호스트에서 여러 복원 작업을 동시에 실행할 수 있는지 결정해요. true
allowed_disk String File()을 사용할 때 백업할 디스크예요. File을 사용하려면 이 설정을 반드시 설정해야 해요. “
allowed_path String File()을 사용할 때 백업할 경로예요. File을 사용하려면 이 설정을 반드시 설정해야 해요. “
attempts_to_collect_metadata_before_sleep UInt 수집된 메타데이터를 비교한 후 불일치가 발생하는 경우 잠자기 전에 메타데이터를 수집하려는 시도 횟수예요. 2
collect_metadata_timeout UInt64 백업 중 메타데이터 수집에 대한 타임아웃(밀리초)이에요. 600000
compare_collected_metadata Bool true이면 수집한 메타데이터를 기존 메타데이터와 비교하여 백업 중 변경되지 않았는지 확인해요. true
create_table_timeout UInt64 복원 중 테이블 생성에 대한 타임아웃(밀리초)이에요. 300000
max_attempts_after_bad_version UInt64 조정된 백업/복원 중 잘못된 버전 오류를 만난 후 재시도하는 최대 횟수예요. 3
max_sleep_before_next_attempt_to_collect_metadata UInt64 다음 메타데이터 수집 시도 전 최대 잠자기 시간(밀리초)이에요. 100
min_sleep_before_next_attempt_to_collect_metadata UInt64 다음 메타데이터 수집 시도 전 최소 잠자기 시간(밀리초)이에요. 5000
remove_backup_files_after_failure Bool BACKUP 명령이 실패하면 ClickHouse가 실패 전에 백업으로 이미 복사된 파일을 제거하려고 시도해요. 그렇지 않으면 복사된 파일을 그대로 둬요. true
sync_period_ms UInt64 조정된 백업/복원의 동기화 주기(밀리초)예요. 5000
test_inject_sleep Bool 테스트 관련 잠자기예요. false
test_randomize_order Bool true이면 테스트 목적으로 특정 작업의 순서를 무작위화해요. false
zookeeper_path String ON CLUSTER 절을 사용할 때 백업 및 복원 메타데이터가 저장되는 ZooKeeper의 경로예요. /clickhouse/backups

이 설정은 기본적으로 다음과 같이 구성돼요.

<backups>
    ....
</backups>

backups_io_thread_pool_queue_size

Backups IO Thread 풀에 스케줄링할 수 있는 최대 작업 수예요. 현재 S3 백업 로직 때문에 이 큐는 무제한으로 유지하는 것이 권장돼요. 값 0(기본값)은 무제한을 의미해요.

더 알아보기 (Learn more)