merge_tree_* 세션 설정

이러한 설정은 system.settings에서 확인할 수 있으며 소스 코드에서 자동 생성됩니다. 데이터를 검색할 때 ClickHouse는 인덱스 파일의 데이터 마크를 확인합니다. 필요한 키가 특정 범위에 있는 것을 발견하면, ClickHouse는 해당 범위를 merge_tree_coarse_index_granularity개의 하위 범위로 나눈 다음 그 안에서 필요한 키를 재귀적으로 검색합니다. 가능한 값:

• 모든 양의 짝수 정수.

이 설정은 ClickHouse Cloud에서만 적용됩니다. 병렬 읽기와 프리페치를 지원하는 멀티버퍼 리더를 사용하기 위한 MergeTree 테이블의 compact 파트 stripe 내 그래뉼 수를 지정합니다. remote fs에서 읽을 때 멀티버퍼 리더를 사용하면 읽기 요청 수가 증가합니다. 파트에 포함된 그래뉼 수가 이 임계값보다 적고, 읽는 컬럼 수보다도 적으면 해당 파트는 단일 버퍼로 읽습니다. 이 경우 단일 버퍼 리더가 멀티버퍼 리더보다 읽기 요청을 더 적게 보내기 때문입니다. 읽기 작업 크기를 결정할 때 prewhere 컬럼의 크기만 사용할지 여부를 설정합니다. 필터를 프라이머리 키의 단일 연속 범위로 평가할 수 없는 경우, 예를 들어 첫 번째가 아닌 키 컬럼을 사용하는 경우 ClickHouse는 인덱스 마크에 대해 반복적인 일반 제외 검색 알고리즘을 실행합니다. 동일한 알고리즘은 텍스트 인덱스 분석에도 사용됩니다. 이 설정은 알고리즘이 각 데이터 파트에 대해 수행하는 단계 수(인덱스 검사 수)를 제한합니다. 예산은 먼저 가장 큰 남은 마크 범위에 사용됩니다. 예산이 소진되면 완전히 분석되지 않은 범위는 전체가 그대로 허용되므로 쿼리의 정확성은 유지되지만, 무제한 검색이 선택했을 때보다 더 많은 그래뉼을 읽을 수 있습니다. 예산을 낮추면 더 많은 데이터를 읽는 대신 인덱스 분석 속도가 빨라집니다. 이 제한은 분석 비용에 대한 엄격한 상한이라기보다 대략적인 값입니다. 검색은 대략 한 번의 분할 라운드 정도 이 한도를 초과할 수 있으며, 파트가 이미 많은 범위로 나뉘어 있는 경우(예: 쿼리 조건 캐시로 인해)에는 제한과 관계없이 각 범위를 최소 한 번씩 검사합니다. 검색이 각 데이터 파트에서 수행한 단계 수는 쿼리의 trace 수준 로그 메시지에 보고되며, IndexGenericExclusionSearchStepLimitReached 및 TextIndexGenericExclusionSearchStepLimitReached profile events는 예산이 소진된 횟수를 집계합니다. (기본) 값 0은 단계 수가 무제한임을 의미합니다. 사용 가능한 값:

• 무제한 단계를 의미하는 0 또는 임의의 양의 정수.

하나의 쿼리에서 ClickHouse가 merge_tree_max_bytes_to_use_cache바이트를 초과하여 읽어야 하면 비압축 블록 캐시를 사용하지 않습니다. 비압축 블록 캐시는 쿼리용으로 추출된 데이터를 저장합니다. ClickHouse는 이 캐시를 사용해 반복적인 소규모 쿼리의 응답 속도를 높입니다. 이 설정은 많은 양의 데이터를 읽는 쿼리로 인해 캐시가 불필요하게 소모되는 것을 방지합니다. uncompressed_cache_size 서버 설정은 비압축 블록 캐시의 크기를 정의합니다. 가능한 값:

• 모든 양의 정수.

ClickHouse가 하나의 쿼리에서 merge_tree_max_rows_to_use_cache보다 많은 행을 읽어야 하는 경우, 비압축 블록 캐시를 사용하지 않습니다. 비압축 블록 캐시는 쿼리를 위해 추출된 데이터를 저장합니다. ClickHouse는 이 캐시를 사용하여 반복적으로 실행되는 소규모 쿼리의 응답 속도를 높입니다. 이 설정은 많은 양의 데이터를 읽는 쿼리로 인해 캐시가 불필요하게 소모되는 것을 방지합니다. uncompressed_cache_size 서버 설정은 비압축 블록 캐시의 크기를 정의합니다. 가능한 값:

• 모든 양의 정수.

MergeTree 엔진 테이블의 한 파일에서 읽어야 할 바이트 수가 merge_tree_min_bytes_for_concurrent_read를 초과하면, ClickHouse는 여러 스레드를 사용해 이 파일을 동시에 읽으려고 시도합니다. 가능한 값:

• 양의 정수.

원격 파일 시스템에서 읽을 때 MergeTree 엔진이 병렬 읽기를 수행하기 전에 단일 파일에서 읽어야 하는 최소 바이트 수입니다. 이 설정은 사용하지 않는 것이 좋습니다. 가능한 값:

• 양의 정수.

하나의 파일에서 읽어야 하는 두 데이터 블록 사이의 거리가 merge_tree_min_bytes_for_seek 바이트보다 작으면, ClickHouse는 추가 seek을 피하기 위해 두 블록이 모두 포함된 파일 범위를 순차적으로 읽습니다. 가능한 값:

• 임의의 양의 정수.

별칭: filesystem_prefetch_min_bytes_for_single_read_task 작업당 읽을 최소 바이트 수입니다. 작업 크기의 엄격한 하한값입니다(그래뉼 수가 적고 사용 가능한 스레드 수가 많더라도 더 작은 작업은 할당하지 않습니다 MergeTree 테이블 파일에서 읽어야 할 행 수가 merge_tree_min_rows_for_concurrent_read를 초과하면 ClickHouse는 여러 스레드를 사용해 해당 파일을 동시에 읽으려고 시도합니다. 가능한 값:

• 양의 정수.

원격 파일 시스템에서 읽는 경우, MergeTree 엔진이 읽기를 병렬화하기 전에 하나의 파일에서 읽어야 하는 최소 행 수입니다. 이 설정의 사용은 권장하지 않습니다. 가능한 값:

• 양의 정수.

하나의 파일에서 읽어야 하는 두 데이터 블록 사이의 거리가 merge_tree_min_rows_for_seek행보다 작으면, ClickHouse는 파일에서 읽기 위치를 이동하지 않고 데이터를 순차적으로 읽습니다. 가능한 값:

• 임의의 양의 정수.

PartsSplitter 테스트용으로, 지정한 확률에 따라 MergeTree에서 읽을 때마다 읽기 범위를 서로 겹치는 범위와 겹치지 않는 범위로 분할합니다. MergeTree 테이블의 스토리지 스냅샷을 생성할 때 인위적인 지연을 추가합니다(밀리초). 테스트 및 디버깅 용도로만 사용하십시오. 가능한 값:

• 0 - 지연 없음(기본값)
• N - 밀리초 단위 지연

원격 테이블에서 읽을 때 일정한 크기의 작업을 사용할지 여부입니다. MergeTree에서 원격 디스크를 읽을 때 파일 프리픽스의 컬럼 메타데이터를 캐시하도록 활성화합니다. MergeTree의 Wide 파트에서 프리픽스를 병렬로 읽을 때 스레드 풀을 사용하도록 설정합니다. 해당 스레드 풀의 크기는 서버 설정 max_prefixes_deserialization_thread_pool_size로 제어됩니다. 활성화하면 MergeTree에서 JSON 및 Dynamic 타입에 V2 대신 V1 직렬화 버전이 사용됩니다. 이 설정 변경은 서버를 다시 시작한 후에만 적용됩니다.