Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

use_skip_indexes_* 세션 설정

이러한 설정은 system.settings에서 확인할 수 있으며 소스 코드에서 자동 생성됩니다.

use_skip_indexes

유형
Bool
기본값
1

쿼리 실행 시 데이터 스키핑 인덱스를 사용합니다.

가능한 값:

  • 0 — 비활성화됨.
  • 1 — 활성화됨.

use_skip_indexes_for_disjunctions

유형
Bool
기본값
1
버전 이력
버전기본값설명
25.121새로운 설정

스킵 인덱스를 사용해 AND와 OR 조건이 혼합된 WHERE 필터를 평가합니다. 예시: WHERE A = 5 AND (B = 5 OR C = 5). 비활성화되어도 스킵 인덱스는 WHERE 조건 평가에 계속 사용되지만, AND로 연결된 절만 포함할 수 있습니다.

가능한 값:

  • 0 — 비활성화됨.
  • 1 — 활성화됨.

use_skip_indexes_for_top_k

유형
Bool
기본값
1
버전 이력
버전기본값설명
26.51기본적으로 TopK 필터링에 데이터 스키핑 인덱스를 사용하도록 설정합니다
25.120새 설정입니다.

TopK 필터링에 데이터 스키핑 인덱스를 사용하도록 설정합니다.

활성화하면 ORDER BY <column> LIMIT n 쿼리의 컬럼에 minmax 스킵 인덱스가 있는 경우, 옵티마이저는 최종 결과와 관련 없는 그래뉼을 건너뛰기 위해 minmax 인덱스를 사용하려고 시도합니다. 이렇게 하면 쿼리 지연 시간을 줄일 수 있습니다.

가능한 값:

  • 0 — 비활성화됩니다.
  • 1 — 활성화됩니다.

use_skip_indexes_if_final

유형
Bool
기본값
1
버전 이력
버전기본값설명
25.61설정 기본값 변경

FINAL 수정자를 사용한 쿼리를 실행할 때 스킵 인덱스를 사용할지 제어합니다.

스킵 인덱스는 최신 데이터가 포함된 행(그래뉼)을 제외할 수 있으므로, FINAL 수정자를 사용하는 쿼리에서 잘못된 결과가 나올 수 있습니다. 이 설정을 활성화하면 FINAL 수정자를 사용하더라도 스킵 인덱스가 적용되어 성능이 향상될 수 있습니다. 정확한 결과는 기본적으로 활성화되어 있으며 스킵 인덱스가 반환한 범위와 겹치는 추가 파트를 스캔하는 use_skip_indexes_if_final_exact_mode 설정에 따라 달라집니다. 최근 UPDATE가 누락될 위험은 해당 설정이 비활성화된 경우에만 있습니다.

가능한 값:

  • 0 — 비활성화.
  • 1 — 활성화.

use_skip_indexes_if_final_exact_mode

유형
Bool
기본값
1
버전 이력
버전기본값설명
25.61설정 기본값 변경
25.50이 설정은 FINAL 쿼리가 스킵 인덱스와 함께 올바른 결과를 반환하도록 돕기 위해 도입되었습니다

이 설정은 FINAL 수정자를 사용한 쿼리 실행 시 올바른 결과를 반환할 수 있도록, 스키핑 인덱스가 반환한 그래뉼을 더 새로운 파트에서 확장할지 여부를 제어합니다.

스킵 인덱스를 사용하면 최신 데이터를 포함한 행이 있는 그래뉼이 제외될 수 있으며, 이로 인해 잘못된 결과가 나올 수 있습니다. 이 설정을 사용하면 스킵 인덱스가 반환한 범위와 겹치는 더 새로운 파트를 스캔하여 올바른 결과를 보장할 수 있습니다. 이 설정은 스킵 인덱스 조회 기반의 근사 결과로도 애플리케이션에 문제가 없는 경우에만 비활성화해야 합니다.

가능한 값:

  • 0 — 비활성화됨.
  • 1 — 활성화됨.

use_skip_indexes_on_data_read

유형
Bool
기본값
1
버전 이력
버전기본값설명
26.21이제 텍스트 인덱스가 일반 제공됩니다
26.10기본적으로 활성화
25.90새로운 설정

데이터를 읽는 동안 데이터 스키핑 인덱스를 사용하도록 설정합니다.

활성화하면 쿼리 실행이 시작되기 전에 미리 분석하는 대신, 각 데이터 그래뉼을 읽는 시점에 스킵 인덱스를 동적으로 평가합니다. 이렇게 하면 쿼리 시작 지연 시간을 줄일 수 있습니다.

가능한 값:

  • 0 — 비활성화됨.
  • 1 — 활성화됨.
Navigation