> ## 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.

# Настройки сеанса optimize_or_like_chain_*

> Настройки сеанса ClickHouse в автоматически сгенерированной группе 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
  }}>Тип</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.settings](/docs/ru/reference/system-tables/settings) и автоматически генерируются на основе [исходного кода](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": "Включено по умолчанию: оптимизирует цепочки OR из LIKE\/ILIKE\/match в multiSearchAny (шаблоны типа «чистая подстрока») или multiMatchAny (другие шаблоны, если разрешён Hyperscan\/Vectorscan); если ни один быстрый путь не применим, исходная цепочка OR остаётся без изменений."}]}]} />

Оптимизирует несколько предикатов `OR LIKE/ILIKE/match` для одного и того же выражения в один вызов `multiSearchAny`/`multiSearchAnyCaseInsensitiveUTF8` (для шаблонов `%needle%` типа `чистая подстрока`) или `multiMatchAny` (для других шаблонов, если разрешён Hyperscan/Vectorscan). Если ни один быстрый путь не применим — например, если Hyperscan отключён или недоступен, либо шаблоны представляют собой необработанные регулярные выражения `match`, не являются корректным UTF-8, содержат встроенный NUL или искомая строка имеет тип `FixedString`/`Enum`, — исходная цепочка `OR` остаётся без изменений, поскольку объединённая альтернатива `match` на базе RE2 стабильно работает медленнее, чем исходный `OR` с коротким замыканием.

Оптимизация применяется только с анализатором (`enable_analyzer = 1`, по умолчанию); со старым анализатором (`enable_analyzer = 0`) цепочка `OR` остаётся без изменений. Для чистых цепочек `OR` из `LIKE`/`ILIKE`/`match` исходные выражения сохраняются в `indexHint()`, чтобы была возможна проверка индексов; смешанные цепочки `OR`, включающие не-`LIKE` ветви, намеренно не оборачиваются в `indexHint()`, чтобы диапазоны, соответствующие только не-`LIKE` ветви, не отсекались. Переписывание в `multiMatchAny` учитывает `allow_hyperscan`, `max_hyperscan_regexp_length`, `max_hyperscan_regexp_total_length` и `reject_expensive_hyperscan_regexps`.

Цепочка переписывается только тогда, когда в ней достаточно ветвей с одинаковым выражением в левой части, чтобы такое переписывание гарантированно работало быстрее, чем вычисление `OR` с коротким замыканием: не менее `optimize_or_like_chain_min_substrings` ветвей для пути `multiSearchAny` и не менее `optimize_or_like_chain_min_patterns` ветвей для пути `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": "Новая настройка, задающая минимальное число ветвей `LIKE`\/`ILIKE`\/`match`, не относящихся к чистой подстроке (с одним и тем же выражением в левой части), необходимое для того, чтобы `optimize_or_like_chain` переписал цепочку в `multiMatchAny`. Более короткие цепочки оставляются без изменений, поскольку переписывание в `multiMatchAny` (Hyperscan) начинает работать быстрее, чем вычисление `OR` с коротким замыканием, только примерно с девяти ветвей."}]}]} />

Минимальное число ветвей `LIKE`/`ILIKE`/`match`, не относящихся к чистой подстроке (шаблоны prefix/suffix/regexp) и использующих одно и то же выражение в левой части, необходимое для того, чтобы `optimize_or_like_chain` переписал цепочку в `multiMatchAny`. Порог откалиброван на наборе данных `hits` (см. `tests/performance/optimize_or_like_chain_hits.xml`): переписывание цепочек `LIKE` с шаблонами prefix/regexp в `multiMatchAny` (Hyperscan) начинает работать быстрее, чем вычисление `OR` с коротким замыканием, только примерно с девяти ветвей, поэтому более короткие цепочки оставляются без изменений, чтобы не ухудшать их производительность. Значение 0 или 1 отключает этот порог. Не действует, если `optimize_or_like_chain` отключён. См. также `optimize_or_like_chain_min_substrings` для варианта с чистой подстрокой (`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": "Новая настройка, задающая минимальное число ветвей LIKE\\/ILIKE с чистой подстрокой (%needle%) (с одним и тем же выражением в левой части), необходимое для того, чтобы optimize_or_like_chain переписал цепочку в multiSearchAny."}]}]} />

Минимальное число ветвей `LIKE`/`ILIKE` с чистой подстрокой (`%needle%`) и одним и тем же выражением в левой части, необходимое для того, чтобы `optimize_or_like_chain` переписал цепочку в `multiSearchAny`/`multiSearchAnyCaseInsensitiveUTF8`. Порог подобран по набору данных `hits` (см. `tests/performance/optimize_or_like_chain_hits.xml`): переписывание в `multiSearchAny` становится быстрее, чем вычисление `OR` с коротким замыканием, примерно начиная с четырёх ветвей. Значение 0 или 1 отключает порог. Не действует, если `optimize_or_like_chain` отключён. См. также `optimize_or_like_chain_min_patterns` для пути с regexp (`multiMatchAny`).