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

# skip_unavailable_shards_* セッション設定

> skip_unavailable_shards_* の生成グループに含まれる 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="skip_unavailable_shards">
  ## skip\_unavailable\_shards
</div>

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

使用不可の分片を通知なしでスキップする機能を有効または無効にします。

この設定の動作は、`skip_unavailable_shards_mode` パラメータによって制御されます。

設定可能な値:

* 1 — スキップが有効です。

  分片が使用不可の場合、ClickHouse は部分的なデータに基づく結果を返し、ノードの可用性の問題は報告しません。

* 0 — スキップが無効です。

  分片が使用不可の場合、ClickHouse は例外をスローします。

<div id="skip_unavailable_shards_mode">
  ## skip\_unavailable\_shards\_mode
</div>

<SettingsInfoBlock type="SkipUnavailableShardsMode" default_value="unavailable_or_table_missing" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.7"},{"label": "unavailable_or_table_missing"},{"label": "`skip_unavailable_shards` が有効なときに、リモート分片からのどの例外を無視するかを制御する新しい設定です。既定値は従来の動作と同じで、テーブルが存在しない分片は使用不可として扱われます。"}]}]} />

`skip_unavailable_shards` が有効なときに、リモート分片からのどの例外をサイレントに無視するかを制御します。`skip_unavailable_shards = 0` の場合、この設定は効果を持ちません。

設定可能な値:

* `unavailable` — 接続関連のエラーのみを無視します。ClickHouse がそのいずれのレプリカにも接続できない場合、またはレプリカのホスト名を DNS で解決できない場合、その分片は使用不可と見なされます。

* `unavailable_or_table_missing` — `unavailable` に加えて、分片上のテーブルまたはデータベースが存在しないことによって発生するエラーも無視します。これは、クラスター全体でテーブルを作成または削除している間に役立ちます。これは既定値であり、テーブルが存在しない分片も使用不可として扱っていた `skip_unavailable_shards` の従来の動作と一致します。

* `unavailable_or_exception_before_processing` — `unavailable` に加えて、分片がイニシエーターにデータブロックを 1 つも返す前に受信したあらゆる例外を無視します。分片がすでに何らかのデータを返した後に到着した例外は、常に再スローされます。なお、「データを返す前」かどうかの判定はイニシエーター側で行われます。分片がブロッキング計算 (たとえば集約、ソート、または `LIMIT BY`) を実行する場合、ブロックを 1 つも出力する前に行を処理して失敗することがあり、その場合はその部分的な処理結果はサイレントに破棄され、クエリは残りの分片から構築された結果を返します。そのため、これは最も許容範囲の広いモードであり、注意して使用する必要があります。