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

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

> إعدادات جلسة ClickHouse ضمن المجموعة المُولَّدة prefer_*.

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 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>;
};

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

<div id="prefer_column_name_to_alias">
  ## prefer\_column\_name\_to\_alias
</div>

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

يُمكّن أو يعطّل استخدام أسماء الأعمدة الأصلية بدلًا من الأسماء المستعارة في تعبيرات الاستعلام وبنوده. وتبرز أهميته خصوصًا عندما يكون الاسم المستعار مطابقًا لاسم العمود؛ راجع [Expression Aliases](/docs/ar/reference/syntax#notes-on-usage). فعّل هذا الإعداد لجعل قواعد استخدام الأسماء المستعارة في ClickHouse أكثر توافقًا مع معظم محركات قواعد البيانات الأخرى.

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

* 0 — يُستبدل اسم العمود بالاسم المستعار.
* 1 — لا يُستبدل اسم العمود بالاسم المستعار.

**مثال**

الفرق بين حالتي التمكين والتعطيل:

الاستعلام:

```sql theme={null}
SET prefer_column_name_to_alias = 0;
SELECT avg(number) AS number, max(number) FROM numbers(10);
```

النتيجة:

```text theme={null}
Received exception from server (version 21.5.1):
Code: 184. DB::Exception: Received from localhost:9000. DB::Exception: Aggregate function avg(number) is found inside another aggregate function in query: While processing avg(number) AS number.
```

الاستعلام:

```sql theme={null}
SET prefer_column_name_to_alias = 1;
SELECT avg(number) AS number, max(number) FROM numbers(10);
```

النتيجة:

```text theme={null}
┌─number─┬─max(number)─┐
│    4.5 │           9 │
└────────┴─────────────┘
```

<div id="prefer_external_sort_block_bytes">
  ## prefer\_external\_sort\_block\_bytes
</div>

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

<VersionHistory rows={[{"id": "row-1","items": [{"label": "24.5"},{"label": "16744704"},{"label": "فضّل الحد الأقصى لحجم الكتلة بالبايتات للفرز الخارجي، وقلّل استهلاك الذاكرة أثناء الدمج."}]}]} />

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

<div id="prefer_global_in_and_join">
  ## prefer\_global\_in\_and\_join
</div>

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

يُفعّل استبدال معاملي `IN`/`JOIN` بـ `GLOBAL IN`/`GLOBAL JOIN`.

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

* 0 — معطّل. لا يتم استبدال معاملي `IN`/`JOIN` بـ `GLOBAL IN`/`GLOBAL JOIN`.
* 1 — مفعّل. يتم استبدال معاملي `IN`/`JOIN` بـ `GLOBAL IN`/`GLOBAL JOIN`.

**الاستخدام**

مع أن `SET distributed_product_mode=global` يمكنه تغيير سلوك الاستعلامات في الجداول الموزعة، فإنه لا يناسب الجداول المحلية أو الجداول القادمة من مصادر خارجية. وهنا تظهر أهمية الإعداد `prefer_global_in_and_join`.

على سبيل المثال، قد تكون لدينا عُقد لخدمة الاستعلامات تحتوي على جداول محلية غير مناسبة للتوزيع. في هذه الحالة نحتاج إلى توزيع بياناتها ديناميكيًا أثناء المعالجة الموزعة باستخدام الكلمة المفتاحية `GLOBAL` — `GLOBAL IN`/`GLOBAL JOIN`.

ومن حالات الاستخدام الأخرى لـ `prefer_global_in_and_join` الوصول إلى الجداول المُنشأة باستخدام محركات خارجية. يساعد هذا الإعداد على تقليل عدد الاستدعاءات إلى المصادر الخارجية عند ربط مثل هذه الجداول: استدعاء واحد فقط لكل استعلام.

**انظر أيضًا:**

* [الاستعلامات الفرعية الموزعة](/docs/ar/reference/statements/in#distributed-subqueries) لمزيد من المعلومات حول كيفية استخدام `GLOBAL IN`/`GLOBAL JOIN`

<div id="prefer_localhost_replica">
  ## prefer\_localhost\_replica
</div>

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

يُفعِّل/يُعطِّل تفضيل استخدام النسخة المتماثلة على localhost عند معالجة الاستعلامات الموزعة.

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

* 1 — يرسل ClickHouse دائمًا الاستعلام إلى النسخة المتماثلة على localhost إذا كانت موجودة.
* 0 — يستخدم ClickHouse استراتيجية موازنة التحميل المحددة في الإعداد [load\_balancing](/docs/ar/reference/settings/session-settings/load-balancing#load_balancing).

<Note>
  عطّل هذا الإعداد إذا كنت تستخدم [max\_parallel\_replicas](/docs/ar/reference/settings/session-settings/max#max_parallel_replicas) بدون [parallel\_replicas\_custom\_key](/docs/ar/reference/settings/session-settings/parallel-replicas#parallel_replicas_custom_key).
  إذا كان [parallel\_replicas\_custom\_key](/docs/ar/reference/settings/session-settings/parallel-replicas#parallel_replicas_custom_key) مضبوطًا، فعطّل هذا الإعداد فقط إذا كان يُستخدم على عنقود يحتوي على عدة أجزاء وعدة نسخ متماثلة.
  أما إذا كان يُستخدم على عنقود يحتوي على جزء واحد وعدة نسخ متماثلة، فسيكون لتعطيل هذا الإعداد آثار سلبية.
</Note>

<div id="prefer_warmed_unmerged_parts_seconds">
  ## prefer\_warmed\_unmerged\_parts\_seconds
</div>

<CloudOnlyBadge />

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

لا يكون لهذا الإعداد أي تأثير إلا في ClickHouse Cloud. إذا كان عمر جزء مدموج أقل من هذا العدد من الثواني ولم يكن مُسخَّنًا مسبقًا (راجع [cache\_populated\_by\_fetch](/docs/ar/reference/settings/merge-tree-settings#cache_populated_by_fetch))، وكانت جميع أجزائه المصدر متاحة ومُسخَّنة مسبقًا، فستقرأ استعلامات SELECT من تلك الأجزاء بدلًا منه. ينطبق هذا فقط على Replicated-/SharedMergeTree. لاحظ أن هذا لا يتحقق إلا مما إذا كان CacheWarmer قد عالج الجزء؛ فإذا كان الجزء قد جُلِب إلى الذاكرة المؤقتة بوسيلة أخرى، فسيظل يُعتبر باردًا إلى أن يعالجه CacheWarmer؛ وإذا كان قد سُخِّن ثم أُخرج من الذاكرة المؤقتة، فسيظل يُعتبر دافئًا.