> ## 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_* セッション設定

> optimize_or_like_chain_* の生成グループに属する ClickHouse セッション設定です。

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/ja/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": "デフォルトで有効: LIKE\/ILIKE\/match の OR 連鎖を、multiSearchAny（単純な部分文字列パターン）または multiMatchAny（その他のパターン。Hyperscan\/Vectorscan が許可されている場合）に最適化します。どちらの高速パスも適用できない場合は、元の OR 連鎖がそのまま保持されます。"}]}]} />

同じ式に対する複数の `OR LIKE/ILIKE/match` 述語を、単一の `multiSearchAny`/`multiSearchAnyCaseInsensitiveUTF8` (単純な部分文字列 `%needle%` パターン用) または `multiMatchAny` (その他のパターン用。Hyperscan/Vectorscan が許可されている場合) に最適化します。どちらの高速パスも適用できない場合 — たとえば、Hyperscan が無効または利用不可である場合、またはパターンが生の `match` 正規表現である場合、UTF-8 として不正な場合、埋め込み NUL を含む場合、あるいは検索対象文字列が `FixedString`/`Enum` である場合 — は、元の `OR` 連鎖がそのまま保持されます。これは、RE2 上で結合した `match` のオルタネーションは、元の短絡 `OR` より一貫して遅いためです。

この最適化は、アナライザ (`enable_analyzer = 1`、デフォルト) を使用している場合にのみ適用されます。古いアナライザ (`enable_analyzer = 0`) では、`OR` 連鎖はそのままです。純粋な `LIKE`/`ILIKE`/`match` の `OR` 連鎖では、索引解析を可能にするため、元の式が `indexHint()` 内に保持されます。`LIKE` 以外の分岐を含む混在 `OR` 連鎖では、`LIKE` 以外の分岐にのみ一致する範囲が prune されないよう、意図的に `indexHint()` でラップしません。`multiMatchAny` への書き換えでは、`allow_hyperscan`、`max_hyperscan_regexp_length`、`max_hyperscan_regexp_total_length`、`reject_expensive_hyperscan_regexps` が考慮されます。

連鎖が書き換えられるのは、同じ左辺式を共有する分岐が十分な数あり、その書き換えが短絡 `OR` 評価より確実に高速になる場合に限られます。`multiSearchAny` 経路では少なくとも `optimize_or_like_chain_min_substrings` 分岐、`multiMatchAny` 経路では少なくとも `optimize_or_like_chain_min_patterns` 分岐が必要です。

<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）への書き換えが short-circuit OR 評価より高速になるのはおよそ 9 個の分岐からであるため、それより短いチェーンはそのまま維持されます。"}]}]} />

同じ左辺式を共有する、純粋な部分文字列ではない `LIKE`/`ILIKE`/`match` 分岐 (プレフィックス/接尾辞/regexp パターン) について、`optimize_or_like_chain` がチェーンを `multiMatchAny` に書き換えるために必要な最小数です。`hits` データセットで調整されています (`tests/performance/optimize_or_like_chain_hits.xml` を参照) 。プレフィックス/regexp の `LIKE` チェーンを `multiMatchAny` (Hyperscan) に書き換えた場合、short-circuit `OR` 評価より高速になるのはおよそ 9 個の分岐からであるため、それより短いチェーンは性能低下を避けるためそのまま維持されます。値が 0 または 1 の場合、しきい値は無効になります。`optimize_or_like_chain` が無効な場合は効果がありません。純粋な部分文字列 (`multiSearchAny`) の経路については、`optimize_or_like_chain_min_substrings` も参照してください。

<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": "同じ 左辺式 を共有する 純粋な部分文字列（`%needle%`）の `LIKE`/`ILIKE` 分岐について、`optimize_or_like_chain` が chain を `multiSearchAny` に Rewrite するために必要な最小数を制御する新しい設定。"}]}]} />

同じ 左辺式 を共有する 純粋な部分文字列 (`%needle%`) の `LIKE`/`ILIKE` 分岐について、`optimize_or_like_chain` が chain を `multiSearchAny`/`multiSearchAnyCaseInsensitiveUTF8` に Rewrite するために必要な最小数です。これは `hits` dataset で較正されており (`tests/performance/optimize_or_like_chain_hits.xml` を参照) 、およそ 4 つの分岐から `multiSearchAny` への Rewrite が short-circuit `OR` 評価より高速になります。値が 0 または 1 の場合、このしきい値は無効になります。`optimize_or_like_chain` が無効な場合は効果がありません。正規表現 (`multiMatchAny`) の経路については、`optimize_or_like_chain_min_patterns` も参照してください。