> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# إعدادات جلسة filesystem_cache_*

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

export const CloudOnlyBadge = () => {
  return <div className="cloudBadge">
            <div className="cloudIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path fillRule="evenodd" clipRule="evenodd" d="M5.33395 12.6667H12.3739C13.6593 12.6667 14.7073 11.6187 14.7073 10.3334C14.7073 9.04804 13.6593 8.00004 12.3739 8.00004H12.0839V7.33337C12.0839 5.12671 10.2906 3.33337 8.08395 3.33337C6.09928 3.33337 4.45395 4.78537 4.14195 6.68204C2.55728 6.76271 1.29395 8.06204 1.29395 9.66671C1.29395 11.3234 2.63728 12.6667 4.29395 12.6667H5.33395Z" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            {'متاح فقط في ClickHouse Cloud'}
        </div>;
};

export const VersionHistory = ({rows = []}) => {
  if (rows.length === 0) {
    return null;
  }
  const headers = ["الإصدار", "القيمة الافتراضية", "التعليق"];
  const border = "1px solid rgba(128, 128, 128, 0.3)";
  const cell = {
    border,
    padding: "0.25rem 0.5rem",
    textAlign: "start",
    verticalAlign: "top"
  };
  return <details className="not-prose" style={{
    border,
    borderRadius: "0.5rem",
    margin: "0.5rem 0",
    padding: "0.5rem 0.75rem",
    fontSize: "0.8125rem",
    lineHeight: "1.125rem"
  }}>
      <summary style={{
    cursor: "pointer",
    fontWeight: 600,
    opacity: 0.72
  }}>
        سجل الإصدارات
      </summary>
      <table style={{
    borderCollapse: "collapse",
    width: "100%",
    margin: "0.5rem 0 0"
  }}>
        <thead>
          <tr>
            {headers.map(header => <th key={header} style={{
    ...cell,
    fontWeight: 600,
    opacity: 0.72
  }}>
                {header}
              </th>)}
          </tr>
        </thead>
        <tbody>
          {rows.map((row, row_index) => <tr key={row.id ?? row_index}>
              {(row.items ?? []).map((item, item_index) => <td key={item_index} style={{
    ...cell,
    overflowWrap: "anywhere"
  }}>
                  {item?.label}
                </td>)}
            </tr>)}
        </tbody>
      </table>
    </details>;
};

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](/ar/reference/system-tables/settings)، وهي مُنشأة تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="filesystem_cache_allow_background_download">
  ## filesystem\_cache\_allow\_background\_download
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "1"},{"label": "إعداد جديد للتحكم في التنزيلات في الخلفية ضمن ذاكرة التخزين المؤقت لنظام الملفات لكل استعلام."}]}]} />

يسمح لذاكرة التخزين المؤقت لنظام الملفات بإدراج التنزيلات في الخلفية للبيانات المقروءة من وحدة تخزين بعيدة. عطّل هذا الخيار للإبقاء على التنزيلات في المقدمة للاستعلام/الجلسة الحالية.

<div id="filesystem_cache_boundary_alignment">
  ## filesystem\_cache\_boundary\_alignment
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "0"},{"label": "إعداد جديد"}]}]} />

محاذاة حدود ذاكرة التخزين المؤقت لنظام الملفات. لا يُطبَّق هذا الإعداد إلا على عمليات القراءة غير المعتمدة على القرص (على سبيل المثال، لذاكرة التخزين المؤقت لمحركات الجداول البعيدة / دوال الجداول، وليس على إعدادات التخزين الخاصة بجداول MergeTree). وتعني القيمة 0 عدم تطبيق أي محاذاة.

<div id="filesystem_cache_enable_background_download_during_fetch">
  ## filesystem\_cache\_enable\_background\_download\_during\_fetch
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "1"},{"label": "إعداد جديد"}]}]} />

يؤثر فقط في ClickHouse Cloud. وقت انتظار قفل ذاكرة التخزين المؤقت لحجز مساحة في ذاكرة التخزين المؤقت لنظام الملفات

<div id="filesystem_cache_enable_background_download_for_metadata_files_in_packed_storage">
  ## filesystem\_cache\_enable\_background\_download\_for\_metadata\_files\_in\_packed\_storage
</div>

<CloudOnlyBadge />

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "1"},{"label": "إعداد جديد"}]}]} />

يسري فقط في ClickHouse Cloud. مدة الانتظار للحصول على قفل ذاكرة التخزين المؤقت لحجز مساحة في ذاكرة التخزين المؤقت لنظام الملفات

<div id="filesystem_cache_max_download_size">
  ## filesystem\_cache\_max\_download\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="137438953472" />

الحد الأقصى لحجم ذاكرة التخزين المؤقت لنظام الملفات البعيد الذي يمكن تنزيله عبر استعلام واحد

<div id="filesystem_cache_name">
  ## filesystem\_cache\_name
</div>

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.10"},{"label": ""},{"label": "اسم ذاكرة التخزين المؤقت لنظام الملفات المُراد استخدامه لمحركات الجداول عديمة الحالة أو بحيرات البيانات"}]}]} />

اسم ذاكرة التخزين المؤقت لنظام الملفات المُراد استخدامه لمحركات الجداول عديمة الحالة أو بحيرات البيانات

<div id="filesystem_cache_prefer_bigger_buffer_size">
  ## filesystem\_cache\_prefer\_bigger\_buffer\_size
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "1"},{"label": "إعداد جديد"}]}]} />

يُفضَّل استخدام حجم ذاكرة مؤقتة أكبر إذا كانت ذاكرة التخزين المؤقت لنظام الملفات مُمكّنة، لتجنّب كتابة مقاطع ملفات صغيرة تُضعف أداء ذاكرة التخزين المؤقت. ومن ناحية أخرى، قد يؤدي تمكين هذا الإعداد إلى زيادة استخدام الذاكرة.

<div id="filesystem_cache_reserve_space_wait_lock_timeout_milliseconds">
  ## filesystem\_cache\_reserve\_space\_wait\_lock\_timeout\_milliseconds
</div>

<SettingsInfoBlock type="UInt64" default_value="1000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.3"},{"label": "1000"},{"label": "مدة الانتظار لقفل ذاكرة التخزين المؤقت لنظام الملفات لحجز مساحة فيها"}]}]} />

مدة الانتظار لقفل ذاكرة التخزين المؤقت لنظام الملفات لحجز مساحة فيها

<div id="filesystem_cache_segments_batch_size">
  ## filesystem\_cache\_segments\_batch\_size
</div>

<SettingsInfoBlock type="UInt64" default_value="20" />

الحد الأقصى لحجم دفعة واحدة من مقاطع الملفات التي يمكن لمخزن القراءة المؤقت طلبها من ذاكرة التخزين المؤقت. ستؤدي القيمة المنخفضة جدًا إلى زيادة الطلبات على ذاكرة التخزين المؤقت، وقد تؤدي القيمة المرتفعة جدًا إلى إبطاء الإخلاء منها

<div id="filesystem_cache_skip_download_if_exceeds_per_query_cache_write_limit">
  ## filesystem\_cache\_skip\_download\_if\_exceeds\_per\_query\_cache\_write\_limit
</div>

**الأسماء البديلة**: `skip_download_if_exceeds_query_cache`

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.11"},{"label": "1"},{"label": "إعادة تسمية الإعداد skip_download_if_exceeds_query_cache_limit"}]}]} />

تخطَّ التنزيل من نظام الملفات البعيد إذا تجاوز حجمه حجم ذاكرة التخزين المؤقت للاستعلام

<div id="filesystem_cache_verbose_logging">
  ## filesystem\_cache\_verbose\_logging
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "0"},{"label": "إعداد جديد يتحكم في رسائل السجل بمستوى TEST التي تُصدر لكل إعادة تعبئة لمخزن القراءة المؤقت لذاكرة التخزين المؤقت لنظام الملفات، والتي كانت تُصدر سابقًا دون قيد متى سمح مستوى السجل بذلك."}]}]} />

أصدر رسائل سجل بمستوى `TEST` لكل إعادة تعبئة لمخزن ذاكرة التخزين المؤقت لنظام الملفات (حالة القراءة، والحجم المتبقي للقراءة، والبايتات المقروءة). مخصصة لتصحيح الأخطاء فقط: تُنسَّق الرسائل مرة واحدة لكل قراءة، لذا فإن تمكينها لاستعلام يجري عددًا كبيرًا من القراءات الصغيرة المخزنة مؤقتًا يضيف عبئًا كبيرًا على التسجيل. ولا تظهر الرسائل إلا إذا كان مستوى السجل هو `test` أصلًا (راجع `send_logs_level`).

<div id="filesystem_cache_wait_for_concurrent_download_timeout_milliseconds">
  ## filesystem\_cache\_wait\_for\_concurrent\_download\_timeout\_milliseconds
</div>

<SettingsInfoBlock type="UInt64" default_value="1000" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.8"},{"label": "1000"},{"label": "إعداد جديد يحدّ من مدة انتظار القراءة لمقطع ملف يجري تنزيله إلى ذاكرة التخزين المؤقت لنظام الملفات بواسطة استعلام متزامن؛ وعند انتهاء المهلة، تتجاوز القراءة ذاكرة التخزين المؤقت بدلاً من الانتظار إلى أجل غير مسمى. تتوافق القيمة السابقة 60000 مع السلوك القديم (دورة انتظار كاملة واحدة مدتها 60 ثانية لعملية التنزيل)."}]}]} />

المدة القصوى لانتظار مقطع ملف يجري تنزيله إلى ذاكرة التخزين المؤقت لنظام الملفات بواسطة استعلام متزامن. عند انتهاء المهلة، تتجاوز القراءة ذاكرة التخزين المؤقت لنظام الملفات لهذا النطاق وتقرأ مباشرةً من وحدة تخزين بعيدة، بينما يستمر التنزيل المتزامن في ملء ذاكرة التخزين المؤقت. تعني القيمة `0` عدم الانتظار مطلقًا: تجاوز ذاكرة التخزين المؤقت فورًا إذا لم يكن النطاق المطلوب قد نُزِّل بعد. يؤدي خفض هذه القيمة إلى الحد من زمن استجابة الذيل لعمليات القراءة التي كانت ستنتظر، عند إصابة ذاكرة التخزين المؤقت، وتيرة تنزيل استعلام آخر، وذلك مقابل إرسال طلبات إضافية إلى وحدة تخزين بعيدة.