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

# paramètres de table MergeTree text_index_*

> Paramètres de table MergeTree de ClickHouse dans le groupe généré text_index_*.

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["Version", "Valeur par défaut", "Commentaire"];
  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
  }}>
        Historique des versions
      </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
  }}>Type</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{type}</div>
      <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>Par défaut</div>
      <div style={{
    overflowWrap: "anywhere"
  }}>{default_value}</div>
      {changeable_without_restart && <div style={{
    fontWeight: 600,
    opacity: 0.72,
    marginInlineStart: "0.5rem"
  }}>
          Modifiable sans redémarrage
        </div>}
      {changeable_without_restart && <div style={{
    overflowWrap: "anywhere"
  }}>
          {changeable_without_restart}
        </div>}
    </div>;
};

Ces paramètres sont disponibles dans [system.merge\_tree\_settings](/fr/reference/system-tables/merge_tree_settings) et sont générés automatiquement à partir du code source de 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": "Nouveau paramètre"}]}]} />

Compression front-coding par défaut des blocs de dictionnaire de l’index de texte.
Peut être surchargée par l’argument d’index explicite `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": "Nouveau paramètre"}]}]} />

Taille de bloc de dictionnaire par défaut pour les index de texte.
Peut être redéfinie par l’argument d’index explicite `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": "Nouveau paramètre. La valeur précédente désactive le vidage basé sur la mémoire afin de préserver le comportement antérieur à la version 26.8"}]}]} />

Estimation maximale de la mémoire utilisée par un générateur d’index de texte avant le vidage d’un segment temporaire.

<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": "Nouveau paramètre"}]}]} />

Nombre maximal de tokens traités accumulés par un générateur d’index de texte avant le vidage d’un segment temporaire.

<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": "Nouveau paramètre"}]}]} />

Taille de bloc par défaut de la posting list pour les index de texte (lignes).
Peut être remplacée par l’argument d’index explicite `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": "Nouveau paramètre"}]}]} />

Codec par défaut de la liste de postings pour les index de texte.
Peut être surchargé par l'argument d'index explicite `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": "Autorise le format d’index de texte « v2_with_positions », qui conserve les positions des jetons pour la recherche de phrase. Revient à « v1_with_codec » avec une compatibilité antérieure afin que les serveurs plus récents continuent d’écrire dans un format lisible par les serveurs plus anciens lors d’une mise à niveau progressive."}]}, {"id": "row-2","items": [{"label": "26.6"},{"label": "v1_with_codec"},{"label": "Nouveau paramètre. Contrôle la version du format des index de texte sur disque. Revient à « v0_initial » avec une compatibilité antérieure afin que les serveurs plus récents continuent d’écrire dans le format précédent, lisible par les serveurs plus anciens lors d’une mise à niveau progressive."}]}]} />

La version préférée du format de sérialisation sur disque pour l’écriture des index de texte.

Ce paramètre constitue une préférence plutôt qu’une contrainte stricte : si la version configurée ne peut pas représenter un index, une version plus récente capable de le représenter est automatiquement choisie, et l’écriture d’un index de texte n’échoue jamais en raison de ce paramètre.

Lors d’une mise à niveau progressive, définissez le format à l’aide du paramètre `compatibility` au niveau du profil sur les serveurs déjà mis à niveau, afin qu’ils continuent d’écrire dans un format que les serveurs plus anciens peuvent toujours lire.

Valeurs possibles :

* `v0_initial` — Le format d’origine. Ne conserve pas le type de codec de la liste de postings.
* `v1_with_codec` — Conserve le type de codec de la liste de postings dans l’en-tête de l’index de texte.
* `v2_with_positions` — Conserve les positions des jetons pour les index avec `support_phrase_search`.
