text_index_* MergeTree 테이블 설정

text_index_* MergeTree 테이블 설정

이 페이지에서는 텍스트 인덱스의 사전(dictionary), 포스팅 리스트(posting list), 직렬화 버전 등의 기본값을 제어하는 text_index_* 계열 설정을 설명할게요. 이 설정들은 system.merge_tree_settings 테이블에서 확인할 수 있고, ClickHouse 소스 코드에서 자동으로 생성된 값이에요.

출처: 문서

본문

이 설정들은 system.merge_tree_settings 테이블에서 확인할 수 있으며, ClickHouse 소스에서 자동으로 생성돼요.

text_index_dictionary_block_frontcoding_compression

텍스트 인덱스 사전 블록의 기본 프론트 코딩(front-coding) 압축이에요. 명시적인 dictionary_block_frontcoding_compression 인덱스 인자로 덮어쓸 수 있어요.

text_index_dictionary_block_size

텍스트 인덱스의 기본 사전 블록 크기예요. 명시적인 dictionary_block_size 인덱스 인자로 덮어쓸 수 있어요.

text_index_max_memory_usage_before_flush

임시 세그먼트를 플러시하기 전에 텍스트 인덱스 빌더가 보유하는 최대 예상 메모리예요.

text_index_max_processed_tokens_before_flush

임시 세그먼트를 플러시하기 전에 텍스트 인덱스 빌더가 축적하는 최대 처리 토큰 수예요.

text_index_posting_list_block_size

텍스트 인덱스의 기본 포스팅 리스트 블록 크기(행 수)예요. 명시적인 posting_list_block_size 인덱스 인자로 덮어쓸 수 있어요.

text_index_posting_list_codec

텍스트 인덱스의 기본 포스팅 리스트 코덱이에요. none, bitpacking, pfor 중 하나예요. 명시적인 posting_list_codec 인덱스 인자로 덮어쓸 수 있어요.

text_index_serialization_version

텍스트 인덱스를 쓸 때 선호하는 디스크 직렬화 형식 버전이에요. 이 설정은 하드 제약이 아니라 선호도(preference)예요: 설정된 버전이 인덱스를 표현할 수 없다면, 표현할 수 있는 더 새로운 버전이 자동으로 선택되며, 이 설정 때문에 텍스트 인덱스 쓰기가 실패하지 않아요. 롤링 업그레이드 중에는 이미 업그레이드된 서버의 프로필 레벨 compatibility 설정으로 형식을 고정해서, 이전 버전 서버가 여전히 읽을 수 있는 형식을 계속 쓰도록 하세요.

가능한 값:

  • v0_initial — 원래 형식이에요. 포스팅 리스트 코덱 타입을 유지하지 않아요.
  • v1_with_codec — 텍스트 인덱스 헤더에 포스팅 리스트 코덱 타입을 유지해요.
  • v2_with_positionssupport_phrase_search가 있는 인덱스의 토큰 위치를 유지해요.

더 알아보기 (Learn more)