storage_* 서버 설정

storage_* 생성 그룹에 속한 ClickHouse 서버 설정입니다.

이 설정은 ClickHouse 서버를 구성하며 ClickHouse 소스에서 자동으로 생성됩니다.

​

storage_configuration

스토리지의 멀티 디스크 구성을 지원합니다.

스토리지 구성은 다음 구조를 따릅니다.

<storage_configuration>
    <disks>
        <!-- configuration -->
    </disks>
    <policies>
        <!-- configuration -->
    </policies>
</storage_configuration>

​

disks 구성

disks 구성은 아래와 같은 구조를 따릅니다:

<storage_configuration>
    <disks>
        <disk_name_1>
            <path>/mnt/fast_ssd/clickhouse/</path>
        </disk_name_1>
        <disk_name_2>
            <path>/mnt/hdd1/clickhouse/</path>
            <keep_free_space_bytes>10485760</keep_free_space_bytes>
        </disk_name_2>
        <disk_name_3>
            <path>/mnt/hdd2/clickhouse/</path>
            <keep_free_space_bytes>10485760</keep_free_space_bytes>
        </disk_name_3>
        ...
    </disks>
</storage_configuration>

위의 하위 태그는 disks에 대해 다음 설정을 정의합니다.

설정	설명
<disk_name_N>	디스크의 이름입니다. 고유해야 합니다.
path	서버 데이터(data 및 shadow 디렉터리)가 저장될 경로입니다. /로 끝나야 합니다.
keep_free_space_bytes	디스크에 예약해 둘 여유 공간의 크기입니다.

디스크의 순서는 중요하지 않습니다.

​

정책 구성

위의 하위 태그는 policies에 대해 다음 설정을 정의합니다.

Setting	Description
policy_name_N	정책 이름입니다. 정책 이름은 고유해야 합니다.
volume_name_N	볼륨 이름입니다. 볼륨 이름은 고유해야 합니다.
disk	볼륨 내에 있는 디스크입니다.
max_data_part_size_bytes	이 볼륨의 어느 디스크에나 저장할 수 있는 데이터 청크의 최대 크기입니다. 머지 결과 생성되는 청크의 예상 크기가 max_data_part_size_bytes보다 크면 해당 청크는 다음 볼륨에 기록됩니다. 이 기능을 사용하면 새롭거나 작은 청크는 핫(SSD) 볼륨에 저장하고, 크기가 커지면 콜드(HDD) 볼륨으로 이동할 수 있습니다. 정책에 볼륨이 하나만 있는 경우에는 이 옵션을 사용하지 마십시오.
move_factor	볼륨에서 사용 가능한 여유 공간의 비율입니다. 여유 공간이 이 값보다 작아지면 다음 볼륨이 있을 경우 데이터가 그 볼륨으로 이동하기 시작합니다. 이동 시에는 청크를 크기순으로 큰 것부터 작은 것까지(내림차순) 정렬한 뒤, 총크기가 move_factor 조건을 충족하기에 충분한 청크를 선택합니다. 모든 청크의 총크기가 충분하지 않으면 모든 청크가 이동됩니다.
perform_ttl_move_on_insert	삽입 시 TTL이 만료된 데이터의 이동을 비활성화합니다. 기본적으로(활성화된 경우) 수명 기반 이동 규칙에 따라 이미 만료된 데이터 조각을 삽입하면 move 규칙에 지정된 볼륨/디스크로 즉시 이동됩니다. 대상 볼륨/디스크가 느린 경우(예: S3) 삽입 성능이 크게 저하될 수 있습니다. 비활성화하면 만료된 데이터 부분은 먼저 기본 볼륨에 기록된 다음, 만료된 TTL에 대해 규칙에 지정된 볼륨으로 즉시 이동됩니다.
load_balancing	디스크 밸런싱 정책으로, round_robin 또는 least_used를 사용합니다.
least_used_ttl_ms	모든 디스크의 사용 가능 공간을 갱신하는 timeout을 설정합니다(밀리초 단위, 0 - 항상 갱신, -1 - 갱신 안 함, 기본값은 60000). 참고로 디스크를 ClickHouse에서만 사용하고 실행 중 파일 시스템 크기 조정이 동적으로 발생하지 않는다면 -1 값을 사용할 수 있습니다. 그 외의 경우에는 결국 잘못된 공간 할당으로 이어질 수 있으므로 권장하지 않습니다.
prefer_not_to_merge	이 볼륨에서 데이터 파트의 머지를 비활성화합니다. 참고: 이는 잠재적으로 해로우며 성능 저하를 일으킬 수 있습니다. 이 설정이 활성화되면(이렇게 하지 마십시오) 이 볼륨에서 데이터 머지가 금지됩니다(바람직하지 않습니다). 이를 통해 ClickHouse가 느린 디스크와 상호 작용하는 방식을 제어할 수 있습니다. 이 설정은 아예 사용하지 않는 것을 권장합니다.
volume_priority	볼륨이 채워지는 우선순위(순서)를 정의합니다. 값이 작을수록 우선순위가 높습니다. 매개변수 값은 자연수여야 하며, 중간에 빠진 값 없이 1부터 N까지의 범위를 모두 포함해야 합니다(N은 지정된 매개변수 값 중 가장 큰 값입니다).

volume_priority의 경우:

• 모든 볼륨에 이 매개변수가 있으면 지정된 순서대로 우선순위가 부여됩니다.
• 일부 볼륨에만 이 매개변수가 있으면, 이 매개변수가 없는 볼륨은 가장 낮은 우선순위를 가집니다. 이 매개변수가 있는 볼륨은 태그 값에 따라 우선순위가 정해지며, 나머지 볼륨끼리의 우선순위는 설정 파일에 기술된 순서에 따라 결정됩니다.
• 어느 볼륨에도 이 매개변수가 지정되지 않으면, 순서는 설정 파일에 기술된 순서로 결정됩니다.
• 볼륨 우선순위는 서로 동일할 수 없습니다.

​

storage_metadata_write_full_object_key

디스크 메타데이터 파일을 VERSION_FULL_OBJECT_KEY 포맷으로 작성합니다. 이 설정은 기본적으로 활성화되어 있습니다. 이 설정은 더 이상 사용을 권장하지 않습니다.

​

storage_shared_set_join_use_inner_uuid

활성화되면 SharedSet 및 SharedJoin 생성 시 내부 UUID가 생성됩니다. ClickHouse Cloud 전용