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

# إعدادات merge_max_* لجدول MergeTree

> إعدادات جدول MergeTree في ClickHouse ضمن المجموعة المُولَّدة merge_max_*.

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.merge\_tree\_settings](/docs/ar/reference/system-tables/merge_tree_settings)، وقد أُنشئت تلقائيًا من الشيفرة المصدرية لـ ClickHouse.

<div id="merge_max_block_size">
  ## merge\_max\_block\_size
</div>

<SettingsInfoBlock type="NonZeroUInt64" default_value="8192" />

عدد الصفوف التي تُقرأ من الأجزاء المدمجة إلى الذاكرة.

القيم الممكنة:

* أي عدد صحيح موجب.

تقرأ عملية الدمج الصفوف من الأجزاء على هيئة كتل بحجم `merge_max_block_size` صفًا، ثم
تدمج النتيجة وتكتبها في جزء جديد. وتوضع الكتلة المقروءة في RAM،
لذلك يؤثر `merge_max_block_size` في حجم RAM المطلوب لعملية الدمج.
وبالتالي، قد تستهلك عمليات الدمج مقدارًا كبيرًا من RAM في الجداول ذات الصفوف العريضة جدًا
(إذا كان متوسط حجم الصف 100kb، فعند دمج 10 أجزاء،
(100kb \* 10 \* 8192) = \~ 8GB من RAM). ومن خلال تقليل `merge_max_block_size`،
يمكنك تقليل مقدار RAM المطلوب لعملية الدمج، ولكن على حساب إبطاء عملية الدمج.

<div id="merge_max_block_size_bytes">
  ## merge\_max\_block\_size\_bytes
</div>

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

عدد البايتات في الكتل التي ينبغي تكوينها لعمليات الدمج. تكون له افتراضيًا
القيمة نفسها لـ `index_granularity_bytes`.

<div id="merge_max_bytes_to_prewarm_cache">
  ## merge\_max\_bytes\_to\_prewarm\_cache
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1073741824"},{"label": "Cloud sync"}]}]} />

متاح فقط في ClickHouse Cloud. الحد الأقصى لحجم الجزء (compact أو packed)
للتهيئة المسبقة لذاكرة التخزين المؤقت أثناء الدمج.

<div id="merge_max_dynamic_subcolumns_in_compact_part">
  ## merge\_max\_dynamic\_subcolumns\_in\_compact\_part
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.1"},{"label": "auto"},{"label": "إضافة إعداد جديد للحد من عدد الأعمدة الفرعية الديناميكية في الجزء Compact بعد الدمج، بغض النظر عن المعلمات المحددة في نوع البيانات"}]}]} />

الحد الأقصى لعدد الأعمدة الفرعية الديناميكية التي يمكن إنشاؤها في كل عمود داخل جزء البيانات Compact بعد الدمج.
ويتيح هذا التحكم في عدد الأعمدة الفرعية الديناميكية في الجزء Compact بغض النظر عن المعلمات الديناميكية المحددة في نوع البيانات.

على سبيل المثال، إذا كان الجدول يحتوي على عمود من النوع JSON(max\_dynamic\_paths=1024) وكان الإعداد merge\_max\_dynamic\_subcolumns\_in\_compact\_part مضبوطًا على 128،
فبعد الدمج في جزء البيانات Compact سيُخفَّض عدد المسارات الديناميكية إلى 128 في هذا الجزء، ولن يُكتَب كأعمدة فرعية ديناميكية سوى 128 مسارًا.

<div id="merge_max_dynamic_subcolumns_in_wide_part">
  ## merge\_max\_dynamic\_subcolumns\_in\_wide\_part
</div>

<SettingsInfoBlock type="UInt64Auto" default_value="auto" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.11"},{"label": "auto"},{"label": "إضافة إعداد جديد للحد من عدد الأعمدة الفرعية الديناميكية في Wide part بعد الدمج، بغض النظر عن المعلمات المحددة في نوع البيانات"}]}]} />

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

على سبيل المثال، إذا كان الجدول يحتوي على عمود من النوع JSON(max\_dynamic\_paths=1024) وكان الإعداد merge\_max\_dynamic\_subcolumns\_in\_wide\_part مضبوطًا على 128،
فبعد الدمج في جزء البيانات Wide سيُخفَّض عدد المسارات الديناميكية إلى 128 في هذا الجزء، ولن يُكتَب كأعمدة فرعية ديناميكية سوى 128 مسارًا.