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

# use_skip_indexes_* セッション設定

> use_skip_indexes_* 生成グループに含まれる 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="use_skip_indexes">
  ## use\_skip\_indexes
</div>

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

クエリ実行時にデータスキッピングインデックスを使用します。

設定可能な値:

* 0 — 無効。
* 1 — 有効。

<div id="use_skip_indexes_for_disjunctions">
  ## use\_skip\_indexes\_for\_disjunctions
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.12"},{"label": "1"},{"label": "新しい設定"}]}]} />

AND と OR が混在する WHERE フィルター条件を、スキップ索引を使用して評価します。例: WHERE A = 5 AND (B = 5 OR C = 5)。
無効にした場合でも、WHERE 条件の評価には引き続きスキップ索引が使用されますが、含められるのは AND で結合された句のみです。

設定可能な値:

* 0 — 無効。
* 1 — 有効。

<div id="use_skip_indexes_for_top_k">
  ## use\_skip\_indexes\_for\_top\_k
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.5"},{"label": "1"},{"label": "既定で TopK フィルタリングにデータスキッピングインデックスを使用する"}]}, {"id": "row-2","items": [{"label": "25.12"},{"label": "0"},{"label": "新しい設定"}]}]} />

TopK フィルタリングでデータスキッピングインデックスを使用します。

有効にすると、`ORDER BY <column> LIMIT n` クエリのカラムに minmax スキップ索引がある場合、オプティマイザは minmax 索引を使って、最終結果に関係しないグラニュールをスキップしようとします。これにより、クエリのレイテンシを低減できます。

設定可能な値:

* 0 — 無効。
* 1 — 有効。

<div id="use_skip_indexes_if_final">
  ## use\_skip\_indexes\_if\_final
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.6"},{"label": "1"},{"label": "設定のデフォルト値の変更"}]}]} />

FINAL 修飾子を使用するクエリの実行時に、スキップ索引を使用するかどうかを制御します。

スキップ索引によって最新データを含む行 (グラニュール) が除外される場合があり、その結果、FINAL 修飾子を使用するクエリで不正確な結果が返されるおそれがあります。この設定を有効にすると、FINAL 修飾子を使用している場合でもスキップ索引が適用されるため、パフォーマンスが向上する可能性がありますが、直近の更新を見逃すリスクがあります。この設定は、use\_skip\_indexes\_if\_final\_exact\_mode 設定と合わせて有効にすることを推奨します (デフォルトでは有効です) 。

設定可能な値:

* 0 — 無効。
* 1 — 有効。

<div id="use_skip_indexes_if_final_exact_mode">
  ## use\_skip\_indexes\_if\_final\_exact\_mode
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.6"},{"label": "1"},{"label": "設定のデフォルト値の変更"}]}, {"id": "row-2","items": [{"label": "25.5"},{"label": "0"},{"label": "この設定は、FINALクエリでスキップ索引を使用した際に正しい結果を返せるように導入されました"}]}]} />

FINAL修飾子を指定してクエリを実行する際に、正しい結果を返せるよう、スキップ索引によって返されたグラニュールを新しいパーツ内で展開するかどうかを制御します。

スキップ索引を使用すると、最新のデータを含む行 (グラニュール) が除外され、誤った結果につながる可能性があります。この設定を有効にすると、スキップ索引が返した範囲と重なる新しいパーツをスキャンすることで、正しい結果を返せるようになります。アプリケーションでスキップ索引の参照に基づく近似結果でも許容できる場合にのみ、この設定を無効にしてください。

設定可能な値:

* 0 — 無効。
* 1 — 有効。

<div id="use_skip_indexes_on_data_read">
  ## use\_skip\_indexes\_on\_data\_read
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.2"},{"label": "1"},{"label": "テキスト索引が GA になりました"}]}, {"id": "row-2","items": [{"label": "26.1"},{"label": "0"},{"label": "デフォルトで有効"}]}, {"id": "row-3","items": [{"label": "25.9"},{"label": "0"},{"label": "新しい設定"}]}]} />

データ読み取り時にデータスキッピングインデックスを使用できるようにします。

有効にすると、スキップ索引はクエリ実行の開始前に事前解析されるのではなく、各データ granule の読み取り時に動的に評価されます。これにより、クエリ開始時のレイテンシを低減できます。

設定可能な値:

* 0 — 無効。
* 1 — 有効。
