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

# إعدادات max_* الخاصة بالجلسة

> إعدادات الجلسة في ClickHouse ضمن المجموعة المُنشأة 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>;
};

export const ExperimentalBadge = () => {
  return <div className="experimentalBadge">
            <div className="experimentalIcon">
            <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path strokeWidth="1.25" d="M5.5 2H10.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M9.50015 2V6.19625L13.4283 12.7425C13.4738 12.8183 13.4985 12.9049 13.4996 12.9934C13.5008 13.0818 13.4785 13.169 13.435 13.246C13.3914 13.323 13.3283 13.3871 13.2519 13.4317C13.1755 13.4764 13.0886 13.4999 13.0002 13.5H3.00015C2.91164 13.5 2.8247 13.4766 2.74822 13.432C2.67174 13.3874 2.60847 13.3233 2.56487 13.2463C2.52126 13.1693 2.49889 13.082 2.50004 12.9935C2.50119 12.905 2.52582 12.8184 2.5714 12.7425L6.50015 6.19625V2" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
                <path strokeWidth="1.25" d="M4.47656 9.56754C5.30344 9.41254 6.47656 9.47942 7.99969 10.25C10.0153 11.2707 11.4216 11.0569 12.2184 10.7282" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
        </div>
            ميزة تجريبية. <u><a href="/docs/docs/beta-and-experimental-features#experimental-features">تعرّف على المزيد.</a></u>
        </div>;
};

هذه الإعدادات متاحة في [system.settings](/docs/ar/reference/system-tables/settings)، وهي مُولَّدة تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).

<div id="max_analyze_depth">
  ## max\_analyze\_depth
</div>

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

الحد الأقصى لعدد عمليات التحليل التي ينفّذها المفسّر.

<div id="max_autoincrement_series">
  ## max\_autoincrement\_series
</div>

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

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

الحد الأقصى لعدد السلاسل التي تُنشئها الدالة `generateSerialID`.

ونظرًا لأن كل سلسلة تمثل عقدة في Keeper، يُستحسن ألا يتجاوز عددها بضعة ملايين.

<div id="max_backup_bandwidth">
  ## max\_backup\_bandwidth
</div>

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

الحد الأقصى لسرعة القراءة، بالبايت في الثانية، لنسخة احتياطية معيّنة على الخادم. تعني القيمة صفر عدم وجود حد.

<div id="max_block_size">
  ## max\_block\_size
</div>

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

في ClickHouse، تُعالَج البيانات على شكل كتل، وهي مجموعات من أجزاء الأعمدة. وتكون دورات المعالجة الداخلية للكتلة الواحدة فعّالة، لكن هناك تكاليف ملحوظة مرتبطة بمعالجة كل كتلة.

يشير الإعداد `max_block_size` إلى الحد الأقصى الموصى به لعدد الصفوف التي ينبغي تضمينها في كتلة واحدة عند تحميل البيانات من الجدول. ولا تُحمَّل دائمًا كتل بحجم `max_block_size` من الجدول: فإذا حدّد ClickHouse أن المطلوب استرجاع بيانات أقل، فستُعالَج كتلة أصغر.

يجب ألا يكون حجم الكتلة صغيرًا جدًا لتجنّب التكاليف الملحوظة عند معالجة كل كتلة. كما يجب ألا يكون كبيرًا جدًا لضمان تنفيذ الاستعلامات التي تتضمن عبارة LIMIT بسرعة بعد معالجة الكتلة الأولى. وعند ضبط `max_block_size`، ينبغي أن يكون الهدف هو تجنّب استهلاك قدر كبير من الذاكرة عند استخراج عدد كبير من الأعمدة عبر خيوط متعددة، مع الحفاظ على قدرٍ من محلية ذاكرة التخزين المؤقت.

<div id="max_columns_to_read">
  ## max\_columns\_to\_read
</div>

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

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

<Tip>
  يفيد هذا الإعداد في منع الاستعلامات المفرطة في التعقيد.
</Tip>

تعني القيمة `0` عدم وجود حد.

<div id="max_compress_block_size">
  ## max\_compress\_block\_size
</div>

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

الحد الأقصى لحجم كتل البيانات غير المضغوطة قبل ضغطها عند الكتابة إلى جدول. تكون القيمة الافتراضية 1,048,576 ‏(1 MiB). ويؤدي تحديد حجم كتلة أصغر عادةً إلى انخفاض طفيف في نسبة الضغط، مع زيادة طفيفة في سرعة الضغط وفك الضغط بسبب محلية ذاكرة التخزين المؤقت، وتقليل استهلاك الذاكرة.

<Note>
  هذا إعداد مخصّص للمستخدمين الخبراء، ولا ينبغي تغييره إذا كنت لا تزال في بداية استخدام ClickHouse.
</Note>

لا تخلط بين الكتل المستخدمة للضغط (وهي جزء من الذاكرة يتكوّن من بايتات) والكتل المستخدمة في معالجة الاستعلامات (وهي مجموعة من الصفوف من جدول).

<div id="max_consume_snapshots">
  ## max\_consume\_snapshots
</div>

<ExperimentalBadge />

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

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

الحد الأقصى لعدد لقطات Paimon التي يمكن استهلاكها في كل قراءة تزايدية. تعني القيمة 0 عدم وجود حد.

<div id="max_estimated_execution_time">
  ## max\_estimated\_execution\_time
</div>

<SettingsInfoBlock type="ثوانٍ" default_value="0" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.1"},{"label": "0"},{"label": "فصل max_execution_time عن max_estimated_execution_time"}]}]} />

الحد الأقصى للوقت التقديري لتنفيذ الاستعلام، بالثواني. ويُتحقَّق منه عند كل كتلة بيانات
عند انتهاء [`timeout_before_checking_execution_speed`](/docs/ar/reference/settings/session-settings/other#timeout_before_checking_execution_speed).

<div id="max_expanded_ast_elements">
  ## max\_expanded\_ast\_elements
</div>

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

الحد الأقصى لحجم شجرة بناء جملة الاستعلام، محسوبًا بعدد العُقد، بعد توسيع الأسماء البديلة والنجمة.

<div id="max_fetch_partition_retries_count">
  ## max\_fetch\_partition\_retries\_count
</div>

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

عدد مرات إعادة المحاولة عند جلب قسم من مضيف آخر.

<div id="max_final_threads">
  ## max\_final\_threads
</div>

<SettingsInfoBlock type="MaxThreads" default_value="auto(N)" />

يحدّد الحد الأقصى لعدد خيوط التنفيذ المتوازية في مرحلة قراءة بيانات استعلام `SELECT` عند استخدام المُعدِّل [FINAL](/docs/ar/reference/statements/select/from#final-modifier).

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

* عدد صحيح موجب.
* 0 أو 1 — معطّل. تُنفَّذ استعلامات `SELECT` باستخدام خيط تنفيذ واحد.

<div id="max_http_get_redirects">
  ## max\_http\_get\_redirects
</div>

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

الحد الأقصى المسموح به لعدد قفزات إعادة توجيه HTTP GET. يضمن ذلك وجود تدابير أمان إضافية لمنع خادم خبيث من إعادة توجيه طلباتك إلى خدمات غير متوقعة.\n\nتحدث هذه الحالة عندما يعيد خادم خارجي التوجيه إلى عنوان آخر، لكن هذا العنوان يبدو داخليًا ضمن البنية التحتية للشركة. وعند إرسال طلب HTTP إلى خادم داخلي، قد تتمكن من طلب واجهة برمجة تطبيقات داخلية من الشبكة الداخلية مع تجاوز المصادقة، أو حتى الاستعلام عن خدمات أخرى مثل Redis أو Memcached. إذا لم تكن لديك بنية تحتية داخلية (بما في ذلك أي شيء يعمل على localhost)، أو كنت تثق في الخادم، فمن الآمن السماح بإعادة التوجيه. ومع ذلك، ضع في اعتبارك أنه إذا كان URL يستخدم HTTP بدلًا من HTTPS، فسيتعين عليك الوثوق ليس فقط بالخادم البعيد، بل أيضًا بمزوّد خدمة الإنترنت لديك وبكل شبكة وسيطة.

Cloud default value: `10`.

<div id="max_limit_for_vector_search_queries">
  ## max\_limit\_for\_vector\_search\_queries
</div>

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

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

استعلامات SELECT التي يتجاوز فيها LIMIT هذا الإعداد لا يمكنها استخدام فهارس تشابه المتجهات. يساعد ذلك على منع تجاوز الذاكرة في فهارس تشابه المتجهات.

<div id="max_number_of_partitions_for_independent_aggregation">
  ## max\_number\_of\_partitions\_for\_independent\_aggregation
</div>

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

الحد الأقصى لعدد الأقسام في الجدول لتطبيق التحسين

<div id="max_os_cpu_wait_time_ratio_to_throw">
  ## max\_os\_cpu\_wait\_time\_ratio\_to\_throw
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.5"},{"label": "0"},{"label": "تم تغيير قيم الإعداد ونقلها إلى 25.4"}]}, {"id": "row-2","items": [{"label": "25.4"},{"label": "0"},{"label": "إعداد جديد"}]}]} />

الحد الأقصى للنسبة بين وقت انتظار CPU في نظام التشغيل (المقياس OSCPUWaitMicroseconds) ووقت الانشغال (المقياس OSCPUVirtualTimeMicroseconds) الذي عنده يُؤخذ رفض الاستعلامات في الاعتبار. يُستخدم الاستيفاء الخطي بين النسبة الدنيا والقصوى لحساب الاحتمال، ويكون الاحتمال 1 عند هذه النقطة.

<div id="max_parallel_replicas">
  ## max\_parallel\_replicas
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.1"},{"label": "1000"},{"label": "استخدم ما يصل إلى 1000 نسخة متماثلة متوازية افتراضيًا."}]}]} />

الحد الأقصى لعدد النسخ المتماثلة لكل shard عند تنفيذ استعلام.

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

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

**معلومات إضافية**

قد يؤدي هذا الخيار إلى نتائج مختلفة بحسب الإعدادات المستخدمة.

<div id="parallel-processing-using-sample-key">
  ### المعالجة المتوازية باستخدام مفتاح `SAMPLE`
</div>

قد يُعالَج الاستعلام بسرعة أكبر إذا نُفِّذ على عدة خوادم بالتوازي. لكن قد يتراجع أداء الاستعلام في الحالات التالية:

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

<div id="parallel-processing-using-parallel_replicas_custom_keyreferencesettingssession-settingsparallel-replicasparallel_replicas_custom_key">
  ### المعالجة المتوازية باستخدام [parallel\_replicas\_custom\_key](/docs/ar/reference/settings/session-settings/parallel-replicas#parallel_replicas_custom_key)
</div>

يفيد هذا الإعداد مع أي جدول مُكرَّر.

<div id="max_parsing_threads">
  ## max\_parsing\_threads
</div>

<SettingsInfoBlock type="MaxThreads" default_value="auto(N)" />

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.4"},{"label": "0"},{"label": "إضافة إعداد منفصل للتحكم في عدد الخيوط المستخدَمة لتحليل البيانات من الملفات بالتوازي"}]}]} />

أقصى عدد من الخيوط لتحليل البيانات في تنسيقات الإدخال التي تدعم التحليل المتوازي. ويُحدَّد هذا العدد تلقائيًا افتراضيًا.

<div id="max_partition_size_to_drop">
  ## max\_partition\_size\_to\_drop
</div>

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

قيد على حذف الأقسام أثناء تنفيذ الاستعلام. وتعني القيمة `0` أنه يمكنك حذف الأقسام دون أي قيود.

Cloud default value: 1 TB.

<Note>
  يتجاوز إعداد الاستعلام هذا إعداد الخادم المقابل له. راجع [max\_partition\_size\_to\_drop](/docs/ar/reference/settings/server-settings/settings#max_partition_size_to_drop)
</Note>

<div id="max_parts_to_move">
  ## max\_parts\_to\_move
</div>

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

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

يحدّد الحد الأقصى لعدد الأجزاء التي يمكن نقلها في استعلام واحد. وتعني القيمة صفر عدم وجود حد.

<div id="max_projection_rows_to_use_projection_index">
  ## max\_projection\_rows\_to\_use\_projection\_index
</div>

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

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

إذا كان عدد الصفوف المراد قراءتها من فهرس الإسقاط أقل من هذه العتبة أو مساويًا لها، فسيحاول ClickHouse تطبيق فهرس الإسقاط أثناء تنفيذ الاستعلام.

<div id="max_query_size">
  ## max\_query\_size
</div>

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

الحد الأقصى لعدد البايتات في سلسلة الاستعلام التي يحللها محلل SQL.
تُعالَج البيانات في عبارة VALUES ضمن استعلامات INSERT بواسطة محلل تدفق منفصل (يستهلك O(1) من RAM)، ولا تتأثر بهذا القيد.

<Note>
  لا يمكن تعيين `max_query_size` داخل استعلام SQL (مثل: `SELECT now() SETTINGS max_query_size=10000`) لأن ClickHouse يحتاج إلى تخصيص مخزن مؤقت لتحليل الاستعلام، ويُحدَّد حجم هذا المخزن المؤقت بواسطة الإعداد `max_query_size`، الذي يجب ضبطه قبل تنفيذ الاستعلام.
</Note>

<div id="max_recursive_cte_evaluation_depth">
  ## max\_recursive\_cte\_evaluation\_depth
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.4"},{"label": "1000"},{"label": "الحد الأقصى لعمق تقييم تعبير الجدول الشائع التكراري"}]}]} />

الحد الأقصى لعمق تقييم تعبير الجدول الشائع التكراري

<div id="max_replica_delay_for_distributed_queries">
  ## max\_replica\_delay\_for\_distributed\_queries
</div>

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

يعطّل النسخ المتماثلة المتأخرة للاستعلامات الموزعة. راجع [النسخ المتماثل](/docs/ar/reference/engines/table-engines/mergetree-family/replication).

يضبط الوقت بالثواني. إذا كان تأخر نسخة متماثلة أكبر من القيمة المحددة أو مساويًا لها، فلن تُستخدم هذه النسخة المتماثلة.

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

* عدد صحيح موجب.
* 0 — لا يتم التحقق من تأخر النسخ المتماثلة.

لمنع استخدام أي نسخة متماثلة ذات تأخر غير صفري، اضبط هذه المعلمة على 1.

يُستخدم عند تنفيذ `SELECT` من جدول موزع يشير إلى جداول خاضعة للنسخ المتماثل.

<div id="max_reverse_dictionary_lookup_cache_size_bytes">
  ## max\_reverse\_dictionary\_lookup\_cache\_size\_bytes
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "25.12"},{"label": "104857600"},{"label": "إعداد جديد. الحد الأقصى للحجم بالبايت لذاكرة التخزين المؤقت لعملية lookup العكسي في القاموس لكل query، والمستخدمة بواسطة الدالة `dictGetKeys`. تخزن ذاكرة التخزين المؤقت قيم Tuple للمفاتيح بعد تسلسلها لكل قيمة سمة، لتجنب إعادة فحص القاموس ضمن الـ query نفسها."}]}]} />

الحد الأقصى للحجم بالبايت لذاكرة التخزين المؤقت لعملية lookup العكسي في القاموس لكل query، والمستخدمة بواسطة الدالة `dictGetKeys`. تخزن ذاكرة التخزين المؤقت قيم Tuple للمفاتيح بعد تسلسلها لكل قيمة سمة، لتجنب إعادة فحص القاموس ضمن الـ query نفسها. عند بلوغ الحد، تُزال العناصر باستخدام LRU. اضبط القيمة على 0 لتعطيل التخزين المؤقت.

<div id="max_sessions_for_user">
  ## max\_sessions\_for\_user
</div>

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

الحد الأقصى لعدد الجلسات المتزامنة لكل مستخدم مُصادَق عليه على خادم ClickHouse.

مثال:

```xml theme={null}
<profiles>
    <single_session_profile>
        <max_sessions_for_user>1</max_sessions_for_user>
    </single_session_profile>
    <two_sessions_profile>
        <max_sessions_for_user>2</max_sessions_for_user>
    </two_sessions_profile>
    <unlimited_sessions_profile>
        <max_sessions_for_user>0</max_sessions_for_user>
    </unlimited_sessions_profile>
</profiles>
<users>
    <!-- User Alice can connect to a ClickHouse server no more than once at a time. -->
    <Alice>
        <profile>single_session_user</profile>
    </Alice>
    <!-- User Bob can use 2 simultaneous sessions. -->
    <Bob>
        <profile>two_sessions_profile</profile>
    </Bob>
    <!-- User Charles can use arbitrarily many of simultaneous sessions. -->
    <Charles>
        <profile>unlimited_sessions_profile</profile>
    </Charles>
</users>
```

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

* عدد صحيح موجب
* `0` - عدد غير محدود من الجلسات المتزامنة (الافتراضي)

<div id="max_subquery_depth">
  ## max\_subquery\_depth
</div>

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

إذا كان الاستعلام يحتوي على عدد من الاستعلامات الفرعية المتداخلة يتجاوز العدد
المحدد، فسيتم طرح استثناء.

<Tip>
  يتيح لك هذا إجراء فحص احترازي لحماية مستخدمي
  العنقود من كتابة استعلامات شديدة التعقيد.
</Tip>

<div id="max_table_size_to_drop">
  ## max\_table\_size\_to\_drop
</div>

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

قيد على حذف الجداول وقت تنفيذ الاستعلام. وتعني القيمة `0` أنه يمكنك حذف جميع الجداول دون أي قيود.

Cloud default value: 1 TB.

<Note>
  يتجاوز إعداد الاستعلام هذا الإعداد المكافئ له على مستوى الخادم، راجع [max\_table\_size\_to\_drop](/docs/ar/reference/settings/server-settings/settings#max_table_size_to_drop)
</Note>

<div id="max_untracked_memory">
  ## max\_untracked\_memory
</div>

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

تُجمَّع عمليات التخصيص وإلغاء التخصيص الصغيرة في متغيّر محلي على مستوى الخيط، ولا تُتبع أو يُنشأ لها ملف تعريف إلا عندما يصبح المقدار (من حيث القيمة المطلقة) أكبر من القيمة المحددة. وإذا كانت القيمة أكبر من `memory_profiler_step`، فسيجري خفضها فعليًا إلى `memory_profiler_step`.

<div id="max_wkb_geometry_elements">
  ## max\_wkb\_geometry\_elements
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "26.4"},{"label": "1000000"},{"label": "إعداد جديد لتقييد عدد العناصر في تحليل بيانات WKB الهندسية، مما يمنع التخصيص المفرط للذاكرة عند وجود بيانات غير سليمة."}]}]} />

الحد الأقصى لعدد النقاط أو الحلقات أو المضلعات المسموح به في عنصر هندسي واحد بصيغة WKB أثناء التحليل بواسطة `readWKB` والدوال ذات الصلة. يوفّر هذا حماية من التخصيصات المفرطة للذاكرة الناتجة عن بيانات WKB غير سليمة. اضبطه على 0 لاستخدام الحد المضمَّن في الشيفرة (100 مليون).