> ## 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_*

> إعدادات جلسة ClickHouse ضمن المجموعة المُنشأة skip_unavailable_shards_*.

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/ar/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 الاتصال بأي من replicas الخاصة به، أو عندما يتعذر تحليل hostname الخاص بـ replica عبر DNS.

* `unavailable_or_table_missing` — بالإضافة إلى `unavailable`، يتم تجاهل الأخطاء الناتجة عن عدم وجود table أو database على الشظية. ويكون ذلك مفيدًا أثناء إنشاء table أو حذفها على مستوى cluster. هذه هي القيمة الافتراضية، وهي تتوافق مع السلوك السابق لـ `skip_unavailable_shards`، الذي كان يعامل أيضًا الشظية التي لا يوجد جدولها على أنها غير متاحة.

* `unavailable_or_exception_before_processing` — بالإضافة إلى `unavailable`، يتم تجاهل أي استثناء يتم استلامه من شظية قبل أن يعيد أي data block إلى initiator. أما الاستثناء الذي يصل بعد أن تكون الشظية قد أعادت بعض البيانات بالفعل، فيُعاد إطلاقه دائمًا. لاحظ أن التحقق من عبارة "قبل أن يعيد أي بيانات" يتم عند initiator: فقد تقوم الشظية التي تنفذ عملية حسابية حاجزة (مثل aggregation أو sort أو `LIMIT BY`) بمعالجة rows ثم تفشل قبل إصدار أي block، وفي هذه الحالة يتم تجاهل عملها الجزئي بصمت ويُرجع query نتيجة مبنية من الشظايا المتبقية. لذلك فهذا هو الوضع الأكثر تساهلًا ويجب استخدامه بحذر.
