> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# text_index_* MergeTree 테이블 설정

> text_index_* 생성 그룹에 속한 ClickHouse MergeTree 테이블 설정입니다.

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["버전", "기본값", "설명"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        버전 이력
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
  return <div className="not-prose" style={{
    display: "flex",
    flexWrap: "wrap",
    alignItems: "baseline",
    columnGap: "0.5rem",
    rowGap: "0.125rem",
    margin: "0.375rem 0",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <div style={{
    fontWeight: 600,
    opacity: 0.72
  }}>유형</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>기본값</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          재시작 없이 변경 가능
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

이러한 설정은 [system.merge\_tree\_settings](/ko/reference/system-tables/merge_tree_settings)에서 확인할 수 있으며, ClickHouse 소스 코드에서 자동 생성됩니다.

<div id="text_index_dictionary_block_frontcoding_compression">
  ## text\_index\_dictionary\_block\_frontcoding\_compression
</div>

<SettingsInfoBlock type="Bool" default_value="1" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1"},{"label": "새로운 설정"}]}]} />

텍스트 인덱스 딕셔너리 블록의 기본 front-coding 압축 설정입니다.
명시적으로 지정한 `dictionary_block_frontcoding_compression` 인덱스 인수로 재정의할 수 있습니다.

<div id="text_index_dictionary_block_size">
  ## text\_index\_dictionary\_block\_size
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="512" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "512"},{"label": "새로운 설정"}]}]} />

텍스트 인덱스의 기본 딕셔너리 블록 크기입니다.
명시적으로 지정한 `dictionary_block_size` 인덱스 인수로 재정의할 수 있습니다.

<div id="text_index_max_memory_usage_before_flush">
  ## text\_index\_max\_memory\_usage\_before\_flush
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="1073741824" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "1073741824"},{"label": "새 설정입니다. 이전 값은 26.8 이전 동작을 유지하기 위해 메모리 기반 플러시를 비활성화합니다"}]}]} />

임시 세그먼트를 플러시하기 전 텍스트 인덱스 빌더가 보유할 수 있는 최대 예상 메모리입니다.

<div id="text_index_max_processed_tokens_before_flush">
  ## text\_index\_max\_processed\_tokens\_before\_flush
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="100000000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "100000000"},{"label": "새로운 설정"}]}]} />

임시 세그먼트를 플러시하기 전 텍스트 인덱스 빌더에 누적될 수 있는 처리된 토큰의 최대 개수입니다.

<div id="text_index_posting_list_block_size">
  ## text\_index\_posting\_list\_block\_size
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="1048576" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "1048576"},{"label": "새로운 설정"}]}]} />

텍스트 인덱스의 기본 포스팅 리스트 블록 크기(행 수)입니다.
명시적으로 지정한 `posting_list_block_size` 인덱스 인수로 재정의할 수 있습니다.

<div id="text_index_posting_list_codec">
  ## text\_index\_posting\_list\_codec
</div>

<SettingsInfoBlock type="TextIndexPostingListCodec" default_value="none" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.6"},{"label": "none"},{"label": "새로운 설정"}]}]} />

텍스트 인덱스의 기본 포스팅 리스트 코덱입니다.
명시적으로 지정한 `posting_list_codec` 인덱스 인수로 재정의할 수 있습니다.

<div id="text_index_serialization_version">
  ## text\_index\_serialization\_version
</div>

<SettingsInfoBlock type="MergeTreeTextIndexSerializationVersion" default_value="v2_with_positions" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "v2_with_positions"},{"label": "구문 검색을 위해 토큰 위치를 저장하는 'v2_with_positions' 텍스트 인덱스 포맷을 허용합니다. 이전 compatibility에서는 'v1_with_codec'로 되돌아가므로, 롤링 업그레이드 중에는 최신 서버가 이전 서버에서 읽을 수 있는 포맷을 계속 작성합니다."}]}, {"id": "row-2","items": [{"label": "26.6"},{"label": "v1_with_codec"},{"label": "새 설정입니다. 텍스트 인덱스의 온디스크 포맷 버전을 제어합니다. 이전 compatibility에서는 'v0_initial'로 되돌아가므로, 롤링 업그레이드 중에는 최신 서버가 이전 서버에서 읽을 수 있는 이전 포맷을 계속 작성합니다."}]}]} />

텍스트 인덱스 작성 시 선호하는 온디스크 직렬화 포맷 버전입니다.

이 설정은 엄격한 제약 조건이 아니라 선호 사항입니다. 구성된 버전으로
인덱스를 표현할 수 없으면 이를 표현할 수 있는 최신 버전이 자동으로 선택되며,
이 설정으로 인해 텍스트 인덱스 작성이 실패하지는 않습니다.

롤링 업그레이드 중에는 이미 업그레이드된 서버에서 프로필 수준의 `compatibility` 설정으로
포맷을 고정하여 이전 서버가 계속 읽을 수 있는 포맷을 작성하도록 하십시오.

가능한 값:

* `v0_initial` — 원래 포맷입니다. 포스팅 리스트 코덱 유형을 저장하지 않습니다.
* `v1_with_codec` — 텍스트 인덱스 헤더에 포스팅 리스트 코덱 유형을 저장합니다.
* `v2_with_positions` — `support_phrase_search`가 있는 인덱스의 토큰 위치를 저장합니다.