> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# paramètres de session optimize_or_like_chain_*

> Paramètres de session ClickHouse du groupe généré optimize_or_like_chain_*.

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.settings](/docs/fr/reference/system-tables/settings) et sont générés automatiquement à partir du [source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="optimize_or_like_chain">
  ## optimize\_or\_like\_chain
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "1"},{"label": "Activé par défaut : optimise les chaînes OR de LIKE\/ILIKE\/match en multiSearchAny (motifs de sous-chaîne pure) ou multiMatchAny (autres motifs, lorsque Hyperscan\/Vectorscan est autorisé) ; si aucun chemin rapide ne s’applique, la chaîne OR d’origine est conservée telle quelle."}]}]} />

Optimise plusieurs prédicats `OR LIKE/ILIKE/match` sur une même expression en un seul `multiSearchAny`/`multiSearchAnyCaseInsensitiveUTF8` (pour les motifs `%needle%` de sous-chaîne pure) ou `multiMatchAny` (pour les autres motifs, lorsque Hyperscan/Vectorscan est autorisé). Lorsqu’aucun chemin rapide n’est applicable — par exemple si Hyperscan est désactivé ou indisponible, si les motifs sont des expressions régulières `match` brutes, ne sont pas en UTF-8 valide, contiennent un NUL intégré, ou si la chaîne recherchée est de type `FixedString`/`Enum` — la chaîne `OR` d’origine est conservée telle quelle, car une alternance `match` combinée sur RE2 est systématiquement plus lente que le `OR` d’origine à court-circuit.

L’optimisation n’est appliquée qu’avec l’analyseur (`enable_analyzer = 1`, valeur par défaut) ; avec l’ancien analyseur (`enable_analyzer = 0`), la chaîne `OR` reste inchangée. Pour les chaînes `OR` pures de `LIKE`/`ILIKE`/`match`, les expressions d’origine sont conservées dans `indexHint()` afin de permettre l’analyse d’index ; les chaînes `OR` mixtes qui incluent des branches non-`LIKE` n’utilisent volontairement pas l’encapsulation `indexHint()` afin que les plages correspondant uniquement à la branche non-`LIKE` ne soient pas élaguées. La réécriture `multiMatchAny` respecte `allow_hyperscan`, `max_hyperscan_regexp_length`, `max_hyperscan_regexp_total_length` et `reject_expensive_hyperscan_regexps`.

Une chaîne n’est réécrite que lorsqu’elle comporte suffisamment de branches partageant la même expression de gauche pour que la réécriture soit de façon fiable plus rapide qu’une évaluation `OR` à court-circuit : au moins `optimize_or_like_chain_min_substrings` branches pour le chemin `multiSearchAny`, et au moins `optimize_or_like_chain_min_patterns` branches pour le chemin `multiMatchAny`.

<div id="optimize_or_like_chain_min_patterns">
  ## optimize\_or\_like\_chain\_min\_patterns
</div>

<SettingsInfoBlock type="UInt64" default_value="10" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "10"},{"label": "Nouveau paramètre contrôlant le nombre minimal de branches LIKE\/ILIKE\/match non de type sous-chaîne pure (partageant la même expression de gauche) requis pour que optimize_or_like_chain réécrive une chaîne en multiMatchAny. Les chaînes plus courtes sont conservées telles quelles, car la réécriture en multiMatchAny (Hyperscan) ne devient plus rapide que l'évaluation OR en court-circuit qu'à partir d'environ neuf branches."}]}]} />

Nombre minimal de branches `LIKE`/`ILIKE`/`match` non de type sous-chaîne pure (motifs de préfixe/suffixe/regexp), partageant la même expression de gauche, requis pour que `optimize_or_like_chain` réécrive une chaîne en `multiMatchAny`. Calibré sur le jeu de données `hits` (voir `tests/performance/optimize_or_like_chain_hits.xml`) : la réécriture en `multiMatchAny` (Hyperscan) de chaînes `LIKE` de préfixe/regexp ne devient plus rapide que l'évaluation `OR` en court-circuit qu'à partir d'environ neuf branches ; les chaînes plus courtes sont donc conservées telles quelles afin d'éviter toute régression. Une valeur de 0 ou 1 désactive ce seuil. N'a aucun effet lorsque `optimize_or_like_chain` est désactivé. Voir aussi `optimize_or_like_chain_min_substrings` pour le cas sous-chaîne pure (`multiSearchAny`).

<div id="optimize_or_like_chain_min_substrings">
  ## optimize\_or\_like\_chain\_min\_substrings
</div>

<SettingsInfoBlock type="UInt64" default_value="4" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "4"},{"label": "Nouveau paramètre contrôlant le nombre minimal de branches LIKE/ILIKE de sous-chaîne pure (%needle%) (partageant la même expression de gauche) nécessaire pour que optimize_or_like_chain réécrive une chaîne en multiSearchAny."}]}]} />

Nombre minimal de branches `LIKE`/`ILIKE` de type sous-chaîne pure (`%needle%`), partageant la même expression de gauche, nécessaire pour que `optimize_or_like_chain` réécrive une chaîne en `multiSearchAny`/`multiSearchAnyCaseInsensitiveUTF8`. Étalonné sur le jeu de données `hits` (voir `tests/performance/optimize_or_like_chain_hits.xml`) : la réécriture en `multiSearchAny` devient plus rapide que l'évaluation `OR` en court-circuit à partir d'environ quatre branches. Une valeur de 0 ou 1 désactive le seuil. N'a aucun effet lorsque `optimize_or_like_chain` est désactivé. Voir aussi `optimize_or_like_chain_min_patterns` pour le chemin regexp (`multiMatchAny`).