> ## 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.
# إعدادات الجلسة الأخرى
> إعدادات جلسة ClickHouse ضمن المجموعة المُولَّدة «أخرى».
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
النوع
{type}
القيمة الافتراضية
{default_value}
{changeable_without_restart &&
يمكن تغييره دون إعادة التشغيل
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
export const CloudOnlyBadge = () => {
return
{'متاح فقط في ClickHouse Cloud'}
;
};
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Beta
;
}
return ;
};
export const ExperimentalBadge = () => {
return ;
};
تتوفّر هذه الإعدادات في [system.settings](/docs/ar/reference/system-tables/settings)، وهي مُولَّدة تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
كتابة ترويسة CORS لـ HTTP.
## analyze\_index\_with\_space\_filling\_curves
إذا كان فهرس جدول ما يتضمن منحنىً مالئًا للفراغ، مثل `ORDER BY mortonEncode(x, y)` أو `ORDER BY hilbertEncode(x, y)`، وكان الاستعلام يتضمن شروطًا على وسائطه، مثل `x >= 10 AND x <= 20 AND y >= 20 AND y <= 30`، فسيُستخدم المنحنى المالئ للفراغ في تحليل الفهرس.
## analyzer\_inline\_views
عند تمكينه، يستبدل analyzer طرق العرض العادية (غير المُجسَّدة وغير المعلَّمة بمعلمات) بالاستعلامات الفرعية التي تعرّفها، مما يتيح تحسينات عابرة للحدود مثل دفع عبارات التصفية وتشذيب الأعمدة.
## any\_join\_distinct\_right\_table\_keys
يُمكّن السلوك القديم لخادم ClickHouse في عمليات `ANY INNER|LEFT JOIN`.
استخدم هذا الإعداد فقط للتوافق مع الإصدارات السابقة إذا كانت حالات الاستخدام لديك تعتمد على سلوك `JOIN` القديم.
عندما يكون السلوك القديم مُمكّنًا:
* لا تتطابق نتائج العمليتين `t1 ANY LEFT JOIN t2` و`t2 ANY RIGHT JOIN t1` لأن ClickHouse يستخدم منطق ربط مفاتيح الجداول من اليسار إلى اليمين بعلاقة متعدد إلى واحد.
* تحتوي نتائج عمليات `ANY INNER JOIN` على جميع صفوف الجدول الأيسر، كما هو الحال في عمليات `SEMI LEFT JOIN`.
عندما يكون السلوك القديم معطّلًا:
* تتطابق نتائج العمليتين `t1 ANY LEFT JOIN t2` و`t2 ANY RIGHT JOIN t1` لأن ClickHouse يستخدم منطقًا يوفّر ربطًا للمفاتيح بعلاقة واحد إلى متعدد في عمليات `ANY RIGHT JOIN`.
* تحتوي نتائج عمليات `ANY INNER JOIN` على صف واحد لكل مفتاح من الجدولين الأيسر والأيمن.
القيم الممكنة:
* 0 — السلوك القديم معطّل.
* 1 — السلوك القديم مُمكّن.
انظر أيضًا:
* [صرامة JOIN](/docs/ar/reference/statements/select/join#settings)
## archive\_adaptive\_buffer\_max\_size\_bytes
يحدّد الحجم الأقصى للمخزن المؤقت المتكيّف المستخدم عند الكتابة إلى ملفات الأرشيف (على سبيل المثال، أرشيفات tar
## arrow\_flight\_request\_descriptor\_type
نوع الواصف المستخدم لطلبات Arrow Flight. يرسل 'path' اسم مجموعة البيانات كواصف path. ويرسل 'command' استعلام SQL كواصف command (وهو مطلوب لـ Dremio).
القيم الممكنة:
* 'path' — استخدم FlightDescriptor::Path (الافتراضي، ويعمل مع معظم خوادم Arrow Flight)
* 'command' — استخدم FlightDescriptor::Command مع استعلام SELECT (مطلوب لـ Dremio)
## backup\_slow\_all\_threads\_after\_retryable\_s3\_error
عند ضبطه على `true`، يتم إبطاء جميع الخيوط التي تنفّذ طلبات S3 إلى نقطة نهاية النسخة الاحتياطية نفسها
إذا واجه أي طلب S3 واحد خطأ S3 قابلاً لإعادة المحاولة، مثل 'Slow Down'.
وعند ضبطه على `false`، يتعامل كل خيط مع التراجع بين محاولات طلبات S3 بشكل مستقل عن الخيوط الأخرى.
## cache\_warmer\_threads
لا يكون لهذا الإعداد تأثير إلا في ClickHouse Cloud. عدد الخيوط الخلفية المخصّصة لتنزيل أجزاء البيانات الجديدة استباقيًا إلى ذاكرة التخزين المؤقت لنظام الملفات عند تمكين [cache\_populated\_by\_fetch](/docs/ar/reference/settings/merge-tree-settings#cache_populated_by_fetch). استخدم القيمة صفر للتعطيل.
## calculate\_text\_stack\_trace
احسب تتبّع المكدس النصي عند حدوث استثناءات أثناء تنفيذ الاستعلام. هذا هو السلوك الافتراضي. ويتطلب ذلك عمليات بحث عن الرموز، ما قد يبطئ اختبارات التشويش عند تنفيذ عدد كبير جدًا من الاستعلامات الخاطئة. وفي الحالات العادية، ينبغي ألا تعطّل هذا الخيار.
## cancel\_http\_readonly\_queries\_on\_client\_close
يلغي استعلامات HTTP للقراءة فقط (مثل `SELECT`) عند إغلاق العميل للاتصال دون انتظار الاستجابة.
القيمة الافتراضية في Cloud: `1`.
## checksum\_on\_read
تحقّق من قيم التحقّق عند القراءة. يكون هذا الإعداد مفعّلًا افتراضيًا، ويجب أن يظل مفعّلًا دائمًا في بيئة الإنتاج. لا يُرجى توقّع أي فائدة من تعطيل هذا الإعداد. وقد يُستخدم فقط لأغراض التجربة واختبارات الأداء. لا ينطبق هذا الإعداد إلا على الجداول من عائلة MergeTree. أمّا في محركات الجداول الأخرى، وعند تلقّي البيانات عبر الشبكة، فيُجرى دائمًا التحقّق من قيم التحقّق.
## connection\_pool\_max\_wait\_ms
زمن الانتظار بالمللي ثانية للحصول على اتصال عندما يكون مجمّع الاتصالات ممتلئًا.
القيم الممكنة:
* عدد صحيح موجب.
* 0 — مهلة انتظار لا نهائية.
## connections\_with\_failover\_max\_tries
الحد الأقصى لعدد محاولات الاتصال بكل نسخة متماثلة لمحرك الجدول Distributed.
## convert\_query\_to\_cnf
عند ضبطه على `true`، سيُحوَّل استعلام `SELECT` إلى الصيغة العادية الاقترانية (CNF). في بعض الحالات، قد يؤدي إعادة كتابة الاستعلام بصيغة CNF إلى تنفيذ أسرع (راجع [مشكلة Github](https://github.com/ClickHouse/ClickHouse/issues/11749) للاطلاع على الشرح).
على سبيل المثال، لاحظ كيف لا يُعدَّل استعلام `SELECT` التالي (وهو السلوك الافتراضي):
```sql theme={null}
EXPLAIN SYNTAX
SELECT *
FROM
(
SELECT number AS x
FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = false;
```
الناتج هو:
```response theme={null}
┌─explain────────────────────────────────────────────────────────┐
│ SELECT x │
│ FROM │
│ ( │
│ SELECT number AS x │
│ FROM numbers(20) │
│ WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) │
│ ) AS a │
│ WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15)) │
│ SETTINGS convert_query_to_cnf = 0 │
└────────────────────────────────────────────────────────────────┘
```
لنضبط `convert_query_to_cnf` على `true` ونرَ ما الذي سيتغير:
```sql theme={null}
EXPLAIN SYNTAX
SELECT *
FROM
(
SELECT number AS x
FROM numbers(20)
) AS a
WHERE ((x >= 1) AND (x <= 5)) OR ((x >= 10) AND (x <= 15))
SETTINGS convert_query_to_cnf = true;
```
لاحظ أن عبارة `WHERE` أُعيدت كتابتها إلى صيغة CNF، لكن مجموعة النتائج هي نفسها تمامًا — فالمنطق البولياني لم يتغير:
```response theme={null}
┌─explain───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ SELECT x │
│ FROM │
│ ( │
│ SELECT number AS x │
│ FROM numbers(20) │
│ WHERE ((x <= 15) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x >= 10) OR (x >= 1)) │
│ ) AS a │
│ WHERE ((x >= 10) OR (x >= 1)) AND ((x >= 10) OR (x <= 5)) AND ((x <= 15) OR (x >= 1)) AND ((x <= 15) OR (x <= 5)) │
│ SETTINGS convert_query_to_cnf = 1 │
└───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```
القيم الممكنة: true, false
## count\_matches\_stop\_at\_empty\_match
يتوقف العدّ بمجرد أن يطابق النمط طولًا صفريًا في الدالة `countMatches`.
## cross\_to\_inner\_join\_rewrite
استخدم INNER JOIN بدلًا من الربط بالفاصلة/CROSS JOIN إذا كانت هناك تعبيرات ربط في قسم WHERE. القيم: 0 - بدون إعادة كتابة، 1 - طبّق ذلك عند الإمكان على الربط بالفاصلة/CROSS JOIN، 2 - افرض إعادة كتابة جميع عمليات الربط بالفاصلة، وCROSS JOIN عند الإمكان
## data\_type\_default\_nullable
يسمح بأن تكون أنواع البيانات في تعريفات الأعمدة التي لا تتضمن مُعدِّلات صريحة [NULL or NOT NULL](/docs/ar/reference/statements/create/table#null-or-not-null-modifiers) من النوع [Nullable](/docs/ar/reference/data-types/nullable).
القيم الممكنة:
* 1 — تُضبط أنواع البيانات في تعريفات الأعمدة على `Nullable` افتراضيًا.
* 0 — تُضبط أنواع البيانات في تعريفات الأعمدة على أنها غير `Nullable` افتراضيًا.
## decimal\_check\_overflow
التحقق من تجاوز السعة في عمليات الحساب/المقارنة العشرية
## deduplicate\_blocks\_in\_dependent\_materialized\_views
يُفعِّل أو يعطِّل التحقق من إزالة التكرار للعروض المادية التي تتلقى البيانات من جداول Replicated\*.
القيم الممكنة:
* 0 — معطّل.
* 1 — مفعّل.
عند التمكين، يُجري ClickHouse إزالة التكرار للكتل في العروض المادية التي تعتمد على جداول Replicated\*.
يفيد هذا الإعداد في ضمان عدم احتواء العروض المادية على بيانات مكررة عند إعادة محاولة عملية الإدراج بسبب حدوث فشل.
**انظر أيضًا**
* [معالجة NULL في عوامل التشغيل `IN`](/docs/ar/concepts/features/operations/insert/deduplicating-inserts-on-retries#insert-deduplication-with-materialized-views)
## defer\_partition\_pruning\_after\_final
عند التمكين (وهو الإعداد الافتراضي)، يتم تخطّي تقليم الأقسام في استعلامات `FINAL` على الجداول التي لا تكون
أعمدة مفتاح القسم فيها جزءًا من مفتاح الفرز. وهذا هو السلوك الآمن من ناحية الصحة
الذي أُدخل في 26.3: فقد يحتاج `FINAL` إلى إزالة تكرار الصفوف التي تشترك في
مفتاح أساسي واحد لكنها موجودة في أقسام مختلفة، وسيؤدي تقليم الأقسام إلى استبعاد
مثل هذه الصفوف بصمت من مدخلات إزالة التكرار.
عند التعطيل، يُطبَّق تقليم الأقسام حتى مع `FINAL`، مما يعيد سلوك ما قبل 26.3.
وقد يكون هذا أسرع بكثير للاستعلامات التي تحتوي على شروط `WHERE` على
عمود القسم، لكنه يكون صحيحًا فقط عندما يستحيل وجود صفوف لها المفتاح الأساسي نفسه
في أقسام مختلفة — مثل جداول سجل الأحداث التي يُحدَّد فيها عمود القسم وقت insert
ولا يتغير مطلقًا.
لا يؤثر هذا الإعداد إلا في الجداول المُقسَّمة التي لا تكون أعمدة مفتاح القسم فيها مُتضمَّنة
ضمن مفتاح الفرز؛ أما في الجداول الأخرى، فيُطبَّق تقليم الأقسام دائمًا.
القيم الممكنة:
* 0 — طبّق تقليم الأقسام قبل `FINAL` (سلوك ما قبل 26.3، أسرع لكنه غير آمن في الحالة العامة).
* 1 — أجّل تقليم الأقسام إلى ما بعد `FINAL` (الافتراضي، آمن من ناحية الصحة).
## describe\_compact\_output
إذا كانت القيمة true، فأدرِج فقط أسماء الأعمدة وأنواعها في نتيجة الاستعلام DESCRIBE
## اللهجة
اللهجة التي ستُستخدم لتحليل الاستعلام
## discard\_query\_data
إذا كان مُمكّنًا، يتجاوز الخادم إرسال صفوف نتيجة الاستعلام إلى العميل. ومع ذلك، يظل الاستعلام يُنفَّذ ويُسجَّل بالكامل على الخادم، كما يواصل العميل تلقي الحزم الأخرى.
يُستخدم لحركة المرور الظلية، واختبارات الأداء، والتشويش.
ليس له أي تأثير على الاستعلامات الثانوية.
يؤثر فقط في بروتوكول TCP الأصلي.
## distinct\_overflow\_mode
يحدّد ما يحدث عند تجاوز كمية البيانات أحد الحدود.
القيم الممكنة:
* `throw`: رفع استثناء (الافتراضي).
* `break`: إيقاف تنفيذ الاستعلام وإرجاع نتيجة جزئية، كما لو أن
بيانات المصدر قد نفدت.
## do\_not\_merge\_across\_partitions\_select\_final
حسّن أداء استعلامات FINAL بتجنّب عمليات الدمج عبر أقسام مختلفة.
عند تفعيل هذا الإعداد، لن تُدمَج الأجزاء من أقسام مختلفة معًا أثناء استعلامات SELECT FINAL. وبدلًا من ذلك، سيقتصر الدمج على الأجزاء داخل كل قسم على حدة. ويمكن أن يحسّن ذلك أداء الاستعلام بشكل كبير عند العمل مع الجداول المُقسّمة.
## dynamic\_throw\_on\_type\_mismatch
عند تطبيق دالة على عمود [Dynamic](/docs/ar/reference/data-types/dynamic) باستخدام التنفيذ الافتراضي،
يحدد هذا الإعداد ما يحدث للصفوف التي يكون نوعها الفعلي غير متوافق مع الدالة:
* `true` (الافتراضي) — طرح استثناء.
* `false` — إرجاع `NULL` لتلك الصفوف بدلًا من ذلك.
## enforce\_strict\_identifier\_format
عند تمكينه، يُسمح فقط بالمعرّفات التي تحتوي على أحرف وأرقام وشرطات سفلية.
## engine\_url\_skip\_empty\_files
يفعّل أو يعطّل تخطي الملفات الفارغة في الجداول التي تستخدم محرك [URL](/docs/ar/reference/engines/table-engines/special/url).
القيم الممكنة:
* 0 — يُطلق `SELECT` استثناءً إذا كان الملف الفارغ غير متوافق مع التنسيق المطلوب.
* 1 — يعيد `SELECT` نتيجة فارغة للملف الفارغ.
## exact\_rows\_before\_limit
عند تفعيل هذا الإعداد، سيقدّم ClickHouse قيمة دقيقة لإحصائية rows\_before\_limit\_at\_least، ولكن سيكون ذلك على حساب ضرورة قراءة البيانات التي تسبق الحد بالكامل
## except\_default\_mode
يضبط الوضع الافتراضي في استعلام EXCEPT. القيم الممكنة: سلسلة فارغة، 'ALL'، 'DISTINCT'. إذا كانت فارغة، فسيؤدي الاستعلام من دون وضع إلى إطلاق استثناء.
## exclude\_materialize\_skip\_indexes\_on\_insert
يستثني فهارس التخطي المحددة من بنائها وتخزينها أثناء عمليات INSERT. وستظل فهارس التخطي المستثناة تُبنى وتُخزَّن [أثناء عمليات الدمج](/docs/ar/reference/settings/merge-tree-settings#materialize_skip_indexes_on_merge) أو من خلال استعلام
[MATERIALIZE INDEX](/docs/ar/reference/statements/alter/skipping-index#materialize-index) صريح.
لا يكون له أي تأثير إذا كانت [materialize\_skip\_indexes\_on\_insert](/docs/ar/reference/settings/session-settings/materialize#materialize_skip_indexes_on_insert) مضبوطة على false.
مثال:
```sql theme={null}
CREATE TABLE tab
(
a UInt64,
b UInt64,
INDEX idx_a a TYPE minmax,
INDEX idx_b b TYPE set(3)
)
ENGINE = MergeTree ORDER BY tuple();
SET exclude_materialize_skip_indexes_on_insert='idx_a'; -- idx_a will be not be updated upon insert
--SET exclude_materialize_skip_indexes_on_insert='idx_a, idx_b'; -- neither index would be updated on insert
INSERT INTO tab SELECT number, number / 50 FROM numbers(100); -- only idx_b is updated
-- since it is a session setting it can be set on a per-query level
INSERT INTO tab SELECT number, number / 50 FROM numbers(100, 100) SETTINGS exclude_materialize_skip_indexes_on_insert='idx_b';
ALTER TABLE tab MATERIALIZE INDEX idx_a; -- this query can be used to explicitly materialize the index
SET exclude_materialize_skip_indexes_on_insert = DEFAULT; -- reset setting to default
```
## execute\_exists\_as\_scalar\_subquery
نفِّذ استعلامات EXISTS الفرعية غير المرتبطة باعتبارها استعلامات فرعية ذات القيمة المفردة. وكما هو الحال في الاستعلامات الفرعية ذات القيمة المفردة، تُستخدم الذاكرة المؤقتة ويُطبَّق طيّ الثوابت على النتيجة.
القيمة الافتراضية في Cloud: `0`.
## explain\_query\_plan\_default
التنسيق الافتراضي الذي يستخدمه `EXPLAIN PLAN`.
القيم الممكنة:
* `pretty` (الافتراضي منذ 26.7) — تكون `actions` و`compact` و`pretty` مضبوطة افتراضيًا على `true`، ما ينتج مخططًا موجزًا ومنسقًا ومشروحًا بالإجراءات.
* `legacy` — المخرجات المستخدمة قبل 26.7.
يؤدي تحديد الخيارات `actions` أو `compact` أو `pretty` صراحةً في تعليمة `EXPLAIN` (على سبيل المثال، `EXPLAIN actions = 0, compact = 0, pretty = 0 SELECT ...`) دائمًا إلى تجاوز هذا الإعداد.
يحتفظ `EXPLAIN PLAN` مع `json = 1` أو `distributed = 1` بالقيم الافتراضية القديمة (قبل 26.7) بغض النظر عن هذا الإعداد، ما لم يتم ضبط `actions` أو `compact` أو `pretty` صراحةً. ولا يمكن لمخرجات `pretty` تمثيل نتائج JSON أو المخططات الموزعة لكل shard، لذا لا تُعرض هذه الأوضاع بشكل صحيح إلا بصيغة `legacy`.
**الأسماء البديلة**: `extract_kvp_max_pairs_per_row`
الحد الأقصى لعدد الأزواج التي يمكن أن تُنتجها الدالة `extractKeyValuePairs`. يُستخدم كإجراء احترازي لمنع استهلاك قدر كبير جدًا من الذاكرة.
## extremes
ما إذا كان سيتم احتساب القيم القصوى (القيم الصغرى والكبرى في أعمدة نتيجة استعلام). يقبل 0 أو 1. القيمة الافتراضية هي 0 (معطّل).
لمزيد من المعلومات، راجع قسم "القيم القصوى".
## fallback\_to\_stale\_replicas\_for\_distributed\_queries
يفرض توجيه الاستعلام إلى نسخة متماثلة قديمة إذا لم تكن البيانات المحدَّثة متاحة. راجع [Replication](/docs/ar/reference/engines/table-engines/mergetree-family/replication).
يختار ClickHouse أكثر النسخ المتماثلة القديمة صلةً بالجدول.
يُستخدم عند تنفيذ `SELECT` من distributed table تشير إلى replicated tables.
افتراضيًا، 1 (مُمكّن).
## file\_like\_engine\_default\_partition\_strategy
استراتيجية التقسيم الافتراضية للمحركات المشابهة للملفات.
## filesystem\_prefetches\_limit
الحد الأقصى لعمليات الجلب المسبق. يشير الصفر إلى عدم وجود حد. ويُوصى باستخدام الإعداد `filesystem_prefetches_max_memory_usage` بدلًا من ذلك إذا كنت تريد تقييد عدد عمليات الجلب المسبق
## final
يطبّق المُعدِّل [FINAL](/docs/ar/reference/statements/select/from#final-modifier) تلقائيًا على جميع الجداول في الاستعلام التي يمكن تطبيق [FINAL](/docs/ar/reference/statements/select/from#final-modifier) عليها، بما في ذلك الجداول المنضمّة والجداول في الاستعلامات الفرعية والجداول الموزعة.
القيم الممكنة:
* 0 - معطّل
* 1 - مُمكّن
مثال:
```sql theme={null}
CREATE TABLE test
(
key Int64,
some String
)
ENGINE = ReplacingMergeTree
ORDER BY key;
INSERT INTO test FORMAT Values (1, 'first');
INSERT INTO test FORMAT Values (1, 'second');
SELECT * FROM test;
┌─key─┬─some───┐
│ 1 │ second │
└─────┴────────┘
┌─key─┬─some──┐
│ 1 │ first │
└─────┴───────┘
SELECT * FROM test SETTINGS final = 1;
┌─key─┬─some───┐
│ 1 │ second │
└─────┴────────┘
SET final = 1;
SELECT * FROM test;
┌─key─┬─some───┐
│ 1 │ second │
└─────┴────────┘
```
## finalize\_projection\_parts\_synchronously
عند تمكين هذا الإعداد، تُنهى أجزاء الإسقاط بشكل متزامن أثناء INSERT، مما يقلل استخدام الذاكرة عند الذروة، ولكن على حساب تقليل توازي الرفع إلى S3. افتراضيًا، يظل تدفق المخرجات لكل إسقاط نشطًا إلى أن يُنهى الجزء بالكامل (بما في ذلك جميع الإسقاطات)، مما يتيح تداخل عمليات الرفع إلى S3، لكنه يزيد استخدام الذاكرة عند الذروة بما يتناسب مع عدد الإسقاطات. لا يؤثر هذا الإعداد إلا في مسار INSERT؛ أما الدمج وعمليات mutation فتُنهي الإسقاطات بشكل متزامن بالفعل.
## flatten\_nested
يضبط تنسيق البيانات لأعمدة [Nested](/docs/ar/reference/data-types/nested-data-structures/index).
القيم الممكنة:
* 1 — يُسطَّح عمود Nested إلى مصفوفات منفصلة.
* 0 — يبقى عمود Nested مصفوفة واحدة من قيم Tuple.
**الاستخدام**
إذا ضُبط هذا الإعداد على `0`، يمكن استخدام أي مستوى من التعشيق.
**أمثلة**
الاستعلام:
```sql theme={null}
SET flatten_nested = 1;
CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();
SHOW CREATE TABLE t_nest;
```
النتيجة:
```text theme={null}
┌─statement───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
`n.a` Array(UInt32),
`n.b` Array(UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```
الاستعلام:
```sql theme={null}
SET flatten_nested = 0;
CREATE TABLE t_nest (`n` Nested(a UInt32, b UInt32)) ENGINE = MergeTree ORDER BY tuple();
SHOW CREATE TABLE t_nest;
```
النتيجة:
```text theme={null}
┌─statement──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ CREATE TABLE default.t_nest
(
`n` Nested(a UInt32, b UInt32)
)
ENGINE = MergeTree
ORDER BY tuple()
SETTINGS index_granularity = 8192 │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```
## fsync\_metadata
يؤدي إلى تمكين [fsync](http://pubs.opengroup.org/onlinepubs/9699919799/functions/fsync.html) أو تعطيله عند كتابة ملفات `.sql`. ويكون مفعّلًا افتراضيًا.
قد يكون من المنطقي تعطيله إذا كان لدى الخادم ملايين الجداول الصغيرة التي تُنشأ وتُحذف باستمرار.
## functions\_h3\_default\_if\_invalid
إذا كانت القيمة false، فستُصدر دوال h3، مثل h3CellAreaM2، استثناءً إذا كان الإدخال غير صالح. وإذا كانت القيمة true، فستُرجع 0 أو القيمة الافتراضية.
## geo\_distance\_returns\_float64\_on\_float64\_arguments
إذا كانت الوسيطات الأربع للدوال `geoDistance` و`greatCircleDistance` و`greatCircleAngle` كلها من النوع Float64، فستُرجِع Float64 وتستخدم دقة مضاعفة في العمليات الحسابية الداخلية. في إصدارات ClickHouse السابقة، كانت هذه الدوال تُرجِع دائمًا Float32.
## geotoh3\_argument\_order
تقبل الدالة 'geoToH3' (lon, lat) إذا ضُبطت على 'lon\_lat'، و(lat, lon) إذا ضُبطت على 'lat\_lon'.
## glob\_expansion\_max\_elements
الحد الأقصى لعدد العناوين المسموح بها (مثل وحدات التخزين الخارجية ودوال الجداول وغيرها).
## h3togeo\_lon\_lat\_result\_order
تعيد الدالة 'h3ToGeo' القيمة (lon, lat) إذا كانت القيمة true، وإلا فتُعيد (lat, lon).
## handshake\_timeout\_ms
مهلة الانتظار بالمللي ثانية لاستلام حزمة Hello من النسخ المتماثلة أثناء المصافحة.
## hedged\_connection\_timeout\_ms
مهلة الاتصال لإنشاء اتصال مع نسخة متماثلة لطلبات Hedged
## highlight\_max\_matches\_per\_row
يحدد الحد الأقصى لعدد المطابقات المبرزة في كل صف في الدالة [highlight](/docs/ar/reference/functions/regular-functions/string-search-functions#highlight). استخدمه للحماية من الإفراط في استخدام الذاكرة عند إبراز الأنماط كثيرة التكرار في النصوص الكبيرة.
القيم الممكنة:
* عدد صحيح موجب.
## hnsw\_candidate\_list\_size\_for\_search
حجم قائمة المرشحين الديناميكية عند البحث في فهرس تشابه المتجهات، ويُعرف أيضًا باسم 'ef\_search'.
## hsts\_max\_age
مدة انتهاء صلاحية HSTS. تعني القيمة 0 تعطيل HSTS.
## idle\_connection\_timeout
مهلة إغلاق اتصالات TCP الخاملة بعد عدد الثواني المحدد.
القيم الممكنة:
* عدد صحيح موجب (0 - إغلاق فوري، بعد 0 ثانية).
## inject\_random\_order\_for\_select\_without\_order\_by
إذا كان مُمكّنًا، فسيُدرج 'ORDER BY rand()' في استعلامات SELECT التي لا تحتوي على بند ORDER BY.
يُطبَّق هذا فقط عندما يكون عمق الاستعلام الفرعي = 0. ولا تتأثر الاستعلامات الفرعية ولا INSERT INTO ... SELECT.
إذا كان التركيب على المستوى الأعلى هو UNION، فسيُدرج 'ORDER BY rand()' في جميع الفروع بشكل مستقل.
هذا مفيد فقط لأغراض الاختبار والتطوير (إذ إن غياب ORDER BY يُعدّ مصدرًا لنتائج استعلام غير حتمية).
## interactive\_delay
الفاصل الزمني بالميكروثانية للتحقق مما إذا كان تنفيذ الطلب قد أُلغي وإرسال معلومات التقدّم.
## intersect\_default\_mode
يُعيّن الوضع الافتراضي في استعلام INTERSECT. القيم الممكنة: سلسلة فارغة، 'ALL'، 'DISTINCT'. إذا كانت القيمة فارغة، فسيؤدي الاستعلام بدون وضع إلى إثارة استثناء.
## least\_greatest\_legacy\_null\_behavior
إذا كان هذا الإعداد ممكّنًا، فستُرجِع الدالتان 'least' و 'greatest' القيمة NULL إذا كانت إحدى وسيطاتهما NULL.
## legacy\_column\_name\_of\_tuple\_literal
أدرِج أسماء جميع عناصر قيم Tuple الحرفية الكبيرة في أسماء الأعمدة بدلًا من hash. هذا الإعداد موجود فقط لأسباب التوافق. من المنطقي ضبطه على 'true' أثناء إجراء تحديث متدرّج للعنقود من إصدار أقل من 21.7 إلى إصدار أعلى.
## limit
يحدّد الحد الأقصى لعدد الصفوف التي يمكن الحصول عليها من نتيجة الاستعلام. ويعدّل القيمة التي تحددها عبارة [LIMIT](/docs/ar/reference/statements/select/limit)، بحيث لا يمكن أن يتجاوز الحد المحدد في الاستعلام الحد الذي يفرضه هذا الإعداد.
القيم الممكنة:
* 0 — عدد الصفوف غير مقيّد.
* عدد صحيح موجب.
## load\_marks\_asynchronously
تحميل علامات MergeTree بصورة غير متزامنة
القيمة الافتراضية في Cloud: `1`.
## lock\_acquire\_timeout
يحدّد عدد الثواني التي ينتظرها طلب القفل قبل أن يفشل.
تُستخدم مهلة القفل للحماية من حالات التوقف المتبادل أثناء تنفيذ عمليات القراءة والكتابة على الجداول. وعند انتهاء المهلة وفشل طلب القفل، يرفع خادم ClickHouse الاستثناء "Locking attempt timed out! Possible deadlock avoided. Client should retry." مع رمز الخطأ `DEADLOCK_AVOIDED`.
القيم الممكنة:
* عدد صحيح موجب (بالثواني).
* 0 — لا توجد مهلة للقفل.
## low\_priority\_query\_wait\_time\_ms
عند استخدام آلية تحديد أولويات الاستعلامات (راجع الإعداد `priority`)، تنتظر الاستعلامات منخفضة الأولوية حتى تنتهي الاستعلامات ذات الأولوية الأعلى. يحدّد هذا الإعداد مدة هذا الانتظار.
## make\_distributed\_plan
إنشاء خطة استعلام موزعة.
## merge\_table\_max\_tables\_to\_look\_for\_schema\_inference
عند إنشاء جدول `Merge` من دون مخطط صريح، أو عند استخدام دالة الجدول `merge`، يُستنتج المخطط باعتباره اتحادًا لما لا يزيد على العدد المحدد من الجداول المطابقة.
إذا كان عدد الجداول أكبر من ذلك، فسيُستنتج المخطط من أول عدد محدد من الجداول.
## mongodb\_throw\_on\_unsupported\_query
إذا كان هذا الخيار مُمكّنًا، فستُرجِع جداول MongoDB خطأً عند تعذّر إنشاء استعلام MongoDB. وإلا، فسيقرأ ClickHouse الجدول بالكامل ويعالجه محليًا. لا ينطبق هذا الخيار عند تعيين 'allow\_experimental\_analyzer=0'.
## multiple\_joins\_try\_to\_keep\_original\_names
لا تُضِف أسماءً مستعارة إلى قائمة التعبيرات على المستوى الأعلى عند إعادة كتابة عمليات الربط المتعددة
## normalize\_function\_names
تطبيع أسماء الدوال إلى صيغها القياسية
## offset
يحدّد عدد الصفوف التي يجب تخطيها قبل البدء في إرجاع الصفوف من الاستعلام. ويُعدّل قيمة الإزاحة المحددة بواسطة عبارة [OFFSET](/docs/ar/reference/statements/select/offset)، بحيث تُجمع هاتان القيمتان.
القيم الممكنة:
* 0 — لا يتم تخطي أي صفوف.
* عدد صحيح موجب.
**مثال**
جدول الإدخال:
```sql theme={null}
CREATE TABLE test (i UInt64) ENGINE = MergeTree() ORDER BY i;
INSERT INTO test SELECT number FROM numbers(500);
```
الاستعلام:
```sql theme={null}
SET limit = 5;
SET offset = 7;
SELECT * FROM test LIMIT 10 OFFSET 100;
```
النتيجة:
```text theme={null}
┌───i─┐
│ 107 │
│ 108 │
│ 109 │
└─────┘
```
## paimon\_target\_snapshot\_id
قراءة لقطة مستهدفة على مستوى الاستعلام لوضع Paimon التزايدي. عند القيمة >0، سيجلب القارئ فقط دلتا
للـ snapshot\_id المحدد دون تقديم المؤشر المائي المعتمد.
القيمة الافتراضية: -1 (معطّل)
## parallelize\_output\_from\_storages
موازاة المخرجات في خطوة القراءة من وحدات التخزين. يتيح هذا إجراء معالجة الاستعلامات بالتوازي مباشرةً بعد القراءة من وحدة التخزين، إذا أمكن ذلك
## partial\_result\_on\_first\_cancel
يسمح بإرجاع نتيجة جزئية للاستعلام بعد الإلغاء.
## per\_part\_index\_stats
يسجّل إحصاءات الفهرس لكل جزء
## poll\_interval
يُعلّق التنفيذ في حلقة انتظار الاستعلام على الخادم لعدد الثواني المحدد.
## polyglot\_dialect
لهجة SQL المصدر لمحوّل polyglot (مثل: 'sqlite' و'mysql' و'postgresql' و'snowflake' و'duckdb').
## postgresql\_fault\_injection\_probability
الاحتمال التقريبي لفشل استعلامات PostgreSQL الداخلية (المستخدمة في النسخ المتماثل). القيمة الصالحة ضمن النطاق \[0.0f, 1.0f]
## predicate\_statistics\_sample\_rate
يجمع إحصاءات انتقائية عبارات الشرط في `system.predicate_statistics_log`. عند تعيينه إلى N > 0، تُؤخذ عيّنة من نحو 1/N من الاستعلامات (استنادًا إلى معرّف الاستعلام). 0 يعني تعطيله.
## prefetch\_buffer\_size
الحد الأقصى لحجم مخزن الجلب المسبق المؤقت المستخدم للقراءة من نظام الملفات. تُقيَّد القيم التي تتجاوز 256 MiB عند 256 MiB، لأن مخزن القراءة المؤقت لا يحتاج مطلقًا إلى حجم أكبر.
## print\_pretty\_type\_names
يسمح بعرض أسماء الأنواع المتداخلة بعمق بصورة منسقة مع مسافات بادئة في query `DESCRIBE` وفي الدالة `toTypeName()`.
مثال:
```sql theme={null}
CREATE TABLE test (a Tuple(b String, c Tuple(d Nullable(UInt64), e Array(UInt32), f Array(Tuple(g String, h Map(String, Array(Tuple(i String, j UInt64))))), k Date), l Nullable(String))) ENGINE=Memory;
DESCRIBE TABLE test FORMAT TSVRaw SETTINGS print_pretty_type_names=1;
```
```
a Tuple(
b String,
c Tuple(
d Nullable(UInt64),
e Array(UInt32),
f Array(Tuple(
g String,
h Map(
String,
Array(Tuple(
i String,
j UInt64
))
)
)),
k Date
),
l Nullable(String)
)
```
## priority
priority الاستعلام. 1 هي الأعلى، وكلما زادت القيمة انخفضت priority؛ 0 يعني عدم استخدام الأولويات.
## push\_external\_roles\_in\_interserver\_queries
تمكين تمرير أدوار المستخدم من العقدة المُرسِلة إلى العُقد الأخرى أثناء تنفيذ استعلام.
## query\_metric\_log\_interval
الفاصل الزمني، بالمللي ثانية، الذي تُجمع عنده بيانات [query\_metric\_log](/docs/ar/reference/system-tables/query_metric_log) لكل استعلام على حدة.
إذا ضُبطت هذه القيمة على أي قيمة سالبة، فستأخذ قيمة `collect_interval_milliseconds` من [إعداد query\_metric\_log](/docs/ar/reference/settings/server-settings/settings#query_metric_log)، أو ستُستخدم القيمة الافتراضية 1000 إذا لم تكن موجودة.
لتعطيل جمع البيانات لاستعلام واحد، اضبط `query_metric_log_interval` على 0.
القيمة الافتراضية: -1
## queue\_max\_wait\_ms
مدة الانتظار في قائمة انتظار الطلبات، إذا تجاوز عدد الطلبات المتزامنة الحد الأقصى.
## rabbitmq\_max\_wait\_ms
مدة الانتظار لقراءة البيانات من RabbitMQ قبل إعادة المحاولة.
## readonly
0 - لا توجد أي قيود على وضع القراءة فقط. 1 - يُسمح فقط بطلبات القراءة، وكذلك بتغيير الإعدادات المسموح بها صراحةً. 2 - يُسمح فقط بطلبات القراءة، وكذلك بتغيير الإعدادات، باستثناء الإعداد 'readonly'.
## recursive\_cte\_max\_steps\_in\_type\_inference
الحد الأقصى لعدد التكرارات لاستنتاج أنواع الأعمدة في تعبيرات الجدول الشائعة التعاودية. تُحدَّد أنواع الأعمدة عبر تطبيق `getLeastSupertype` تكراريًا على الطرفين غير التعاودي والتعاودي من UNION ALL حتى الوصول إلى حالة الاستقرار. اضبط القيمة على 0 لتعطيل توسيع الأنواع والاكتفاء بالأنواع من الجزء غير التعاودي فقط.
## regexp\_max\_matches\_per\_row
يحدّد الحد الأقصى لعدد المطابقات لتعبير نمطي واحد في كل صف. استخدمه للحماية من الاستهلاك المفرط للذاكرة عند استخدام تعبير نمطي جشع في الدالة [extractAllGroupsHorizontal](/docs/ar/reference/functions/regular-functions/string-search-functions#extractAllGroupsHorizontal).
القيم الممكنة:
* عدد صحيح موجب.
## reject\_expensive\_hyperscan\_regexps
استبعِد الأنماط التي يُحتمل أن يكون تقييمها مكلفًا باستخدام hyperscan (بسبب التضخم في حالات NFA)
## remerge\_sort\_lowered\_memory\_bytes\_ratio
إذا لم ينخفض استهلاك الذاكرة بعد إعادة الدمج بهذه النسبة، فسيتم تعطيل إعادة الدمج.
## remote\_read\_min\_bytes\_for\_seek
الحد الأدنى من البايتات المطلوب للقراءة عن بُعد (URL، S3) لإجراء seek بدلًا من القراءة مع ignore.
## rename\_files\_after\_processing
* **النوع:** String
* **القيمة الافتراضية:** سلسلة فارغة
يتيح هذا الإعداد تحديد نمط لإعادة تسمية الملفات التي تعالجها دالة الجدول `file`. عند تعيين هذا الخيار، ستُعاد تسمية جميع الملفات التي تقرؤها دالة الجدول `file` وفقًا للنمط المحدد باستخدام العناصر النائبة، وذلك فقط إذا تمت معالجة الملفات بنجاح.
### العناصر النائبة
* `%a` — اسم الملف الأصلي كاملًا (على سبيل المثال، "sample.csv").
* `%f` — اسم الملف الأصلي بدون امتداد (على سبيل المثال، "sample").
* `%e` — امتداد الملف الأصلي متضمّنًا النقطة (على سبيل المثال، ".csv").
* `%t` — الطابع الزمني (بالميكروثانية).
* `%%` — علامة النسبة المئوية ("%").
### مثال
* الخيار: `--rename_files_after_processing="processed_%f_%t%e"`
* الاستعلام: `SELECT * FROM file('sample.csv')`
إذا تمت قراءة `sample.csv` بنجاح، فسيُعاد تسمية الملف إلى `processed_sample_1683473210851438.csv`
## replication\_wait\_for\_inactive\_replica\_timeout
يحدّد مدة الانتظار (بالثواني) حتى تنفّذ النسخ المتماثلة غير النشطة استعلامات [`ALTER`](/docs/ar/reference/statements/alter/index) أو [`OPTIMIZE`](/docs/ar/reference/statements/optimize) أو [`TRUNCATE`](/docs/ar/reference/statements/truncate).
القيم الممكنة:
* `0` — عدم الانتظار.
* عدد صحيح سالب — الانتظار لمدة غير محدودة.
* عدد صحيح موجب — عدد الثواني المطلوب انتظارها.
## reserve\_memory
يُستخدم هذا الإعداد في جدولة أعباء العمل. وهو الحد الأدنى من RAM المحجوزة لاستخدامها لتشغيل استعلام على خادم واحد. ويُجرى الحجز عبر التسلسل الهرمي لـ WORKLOAD باستخدام قيمة إعداد الاستعلام `workload`.
إذا لم تكن هناك ذاكرة كافية متاحة لعبء العمل، فسيُمنع الاستعلام من البدء وينتظر في حالة pending إلى أن يمكن تلبية الحجز.
تعني القيمة `0` عدم وجود حجز.
لا يسري هذا الإعداد إلا إذا تم إنشاء مورد MEMORY RESERVATION.
## restore\_replicated\_merge\_tree\_to\_shared\_merge\_tree
استبدال محرك الجدول من Replicated*MergeTree إلى Shared*MergeTree أثناء RESTORE.
القيمة الافتراضية في Cloud: `1`.
## result\_overflow\_mode
يحدّد ما يجب فعله إذا تجاوز حجم النتيجة أحد الحدود.
القيم الممكنة:
* `throw`: يرفع استثناءً (الافتراضي).
* `break`: يوقف تنفيذ الاستعلام ويُرجع نتيجة جزئية، كما لو أن
البيانات المصدرية قد نفدت.
يشبه استخدام 'break' استخدام LIMIT. ولا يوقف `Break` التنفيذ إلا على
مستوى الكتلة. وهذا يعني أن عدد الصفوف المُعادة يكون أكبر من
[`max_result_rows`](/docs/ar/reference/settings/session-settings/max-result#max_result_rows)، ومن مضاعفات [`max_block_size`](/docs/ar/reference/settings/session-settings/max#max_block_size)
ويعتمد على [`max_threads`](/docs/ar/reference/settings/session-settings/max-threads#max_threads).
**مثال**
```sql title="Query" theme={null}
SET max_threads = 3, max_block_size = 3333;
SET max_result_rows = 3334, result_overflow_mode = 'break';
SELECT *
FROM numbers_mt(100000)
FORMAT Null;
```
```text title="Result" theme={null}
6666 rows in set. ...
```
## rows\_before\_aggregation
عند التمكين، يوفّر ClickHouse قيمة دقيقة لإحصائية rows\_before\_aggregation، التي تمثل عدد الصفوف المقروءة قبل التجمي
## secondary\_indices\_enable\_bulk\_filtering
يُفعِّل خوارزمية التصفية المجمّعة للفهارس. ومن المتوقع أن تكون أفضل دائمًا، لكن هذا الإعداد متاح لأغراض التوافق والتحكم.
## select\_sequential\_consistency
يختلف سلوك هذا الإعداد بين SharedMergeTree وReplicatedMergeTree. راجع [SharedMergeTree consistency](/docs/ar/products/cloud/features/infrastructure/shared-merge-tree#consistency) لمزيد من المعلومات حول سلوك `select_sequential_consistency` في SharedMergeTree.
يمكّن أو يعطّل الاتساق التسلسلي لاستعلامات `SELECT`. ويتطلب ذلك تعطيل `insert_quorum_parallel` (وهو مُمكَّن افتراضيًا).
القيم الممكنة:
* 0 — معطّل.
* 1 — مُمكَّن.
الاستخدام
عند تمكين الاتساق التسلسلي، لا يسمح ClickHouse للعميل بتنفيذ استعلام `SELECT` إلا على النسخ المتماثلة التي تحتوي على بيانات جميع استعلامات `INSERT` السابقة المُنفَّذة باستخدام `insert_quorum`. وإذا أشار العميل إلى نسخة متماثلة غير مكتملة، فسينشئ ClickHouse استثناءً. ولن يتضمن استعلام `SELECT` البيانات التي لم تُكتب بعد إلى نصاب النسخ المتماثلة.
عندما يكون `insert_quorum_parallel` مُمكَّنًا (وهو الإعداد الافتراضي)، فإن `select_sequential_consistency` لا يعمل. ويعود ذلك إلى أن استعلامات `INSERT` المتوازية قد تُكتب إلى مجموعات مختلفة من النسخ المتماثلة ضمن النصاب، لذلك لا يوجد ما يضمن أن نسخة متماثلة واحدة قد استلمت جميع عمليات الكتابة.
انظر أيضًا:
* [insert\_quorum](/docs/ar/reference/settings/session-settings/insert-quorum#insert_quorum)
* [insert\_quorum\_timeout](/docs/ar/reference/settings/session-settings/insert-quorum#insert_quorum_timeout)
* [insert\_quorum\_parallel](/docs/ar/reference/settings/session-settings/insert-quorum#insert_quorum_parallel)
## session\_timezone
يضبط المنطقة الزمنية الضمنية للجلسة الحالية أو للاستعلام الحالي.
المنطقة الزمنية الضمنية هي المنطقة الزمنية المُطبَّقة على القيم من النوع DateTime/DateTime64 التي لا تكون لها منطقة زمنية محددة صراحةً.
يتقدّم هذا الإعداد على المنطقة الزمنية الضمنية المضبوطة عمومًا (على مستوى الخادم).
تعني القيمة '' (سلسلة فارغة) أن المنطقة الزمنية الضمنية للجلسة الحالية أو للاستعلام الحالي تساوي [المنطقة الزمنية للخادم](/docs/ar/reference/settings/server-settings/settings#timezone).
يمكنك استخدام الدالتين `timeZone()` و`serverTimeZone()` للحصول على المنطقة الزمنية للجلسة والمنطقة الزمنية للخادم.
القيم الممكنة:
* أي اسم منطقة زمنية من `system.time_zones`، مثل `Europe/Berlin` أو `UTC` أو `Zulu`
أمثلة:
```sql theme={null}
SELECT timeZone(), serverTimeZone() FORMAT CSV
"Europe/Berlin","Europe/Berlin"
```
```sql theme={null}
SELECT timeZone(), serverTimeZone() SETTINGS session_timezone = 'Asia/Novosibirsk' FORMAT CSV
"Asia/Novosibirsk","Europe/Berlin"
```
عيّن المنطقة الزمنية للجلسة 'America/Denver' لقيمة DateTime الداخلية من دون تحديد المنطقة الزمنية صراحةً:
```sql theme={null}
SELECT toDateTime64(toDateTime64('1999-12-12 23:23:23.123', 3), 3, 'Europe/Zurich') SETTINGS session_timezone = 'America/Denver' FORMAT TSV
1999-12-13 07:23:23.123
```
ليست كل الدوال التي تُحلِّل DateTime/DateTime64 تراعي `session_timezone`. وقد يؤدي ذلك إلى أخطاء خفية.
راجع المثال والشرح التاليين.
```sql theme={null}
CREATE TABLE test_tz (`d` DateTime('UTC')) ENGINE = Memory AS SELECT toDateTime('2000-01-01 00:00:00', 'UTC');
SELECT *, timeZone() FROM test_tz WHERE d = toDateTime('2000-01-01 00:00:00') SETTINGS session_timezone = 'Asia/Novosibirsk'
0 rows in set.
SELECT *, timeZone() FROM test_tz WHERE d = '2000-01-01 00:00:00' SETTINGS session_timezone = 'Asia/Novosibirsk'
┌───────────────────d─┬─timeZone()───────┐
│ 2000-01-01 00:00:00 │ Asia/Novosibirsk │
└─────────────────────┴──────────────────┘
```
يحدث هذا بسبب اختلاف مسارات التحليل:
* إن `toDateTime()` من دون تحديد `time zone` صراحةً، والمستخدمة في استعلام `SELECT` الأول، تراعي الإعداد `session_timezone` والمنطقة الزمنية العامة.
* في الاستعلام الثاني، يُحلَّل `DateTime` من `String`، ويرث النوع والمنطقة الزمنية للعمود الحالي `d`. لذلك، لا يُراعى الإعداد `session_timezone` ولا المنطقة الزمنية العامة.
**انظر أيضًا**
* [timezone](/docs/ar/reference/settings/server-settings/settings#timezone)
## set\_overflow\_mode
يحدد ما يحدث عندما تتجاوز كمية البيانات أحد الحدود.
القيم الممكنة:
* `throw`: رفع استثناء (الافتراضي).
* `break`: إيقاف تنفيذ الاستعلام وإرجاع نتيجة جزئية، كما لو أن
بيانات المصدر قد نفدت.
## single\_join\_prefer\_left\_table
عند وجود JOIN واحدة، وفي حال التباس المعرّف، فَضِّل الجدول الأيسر
## skip\_redundant\_aliases\_in\_udf
لا تُستخدم الأسماء المستعارة الزائدة (ولا يُستعاض بها) في الدوال المعرّفة من قبل المستخدم، وذلك لتبسيط استخدامها.
القيم الممكنة:
* 1 — يتم تجاوز الأسماء المستعارة (الاستعاضة عنها) في UDFs.
* 0 — لا يتم تجاوز الأسماء المستعارة (الاستعاضة عنها) في UDFs.
**مثال**
الفرق بين حالتي التمكين والتعطيل:
الاستعلام:
```sql theme={null}
SET skip_redundant_aliases_in_udf = 0;
CREATE FUNCTION IF NOT EXISTS test_03274 AS ( x ) -> ((x + 1 as y, y + 2));
EXPLAIN SYNTAX SELECT test_03274(4 + 2);
```
النتيجة:
```text theme={null}
SELECT ((4 + 2) + 1 AS y, y + 2)
```
الاستعلام:
```sql theme={null}
SET skip_redundant_aliases_in_udf = 1;
CREATE FUNCTION IF NOT EXISTS test_03274 AS ( x ) -> ((x + 1 as y, y + 2));
EXPLAIN SYNTAX SELECT test_03274(4 + 2);
```
النتيجة:
```text theme={null}
SELECT ((4 + 2) + 1, ((4 + 2) + 1) + 2)
```
## sleep\_after\_receiving\_query\_ms
مدة الانتظار بعد استلام الاستعلام في TCPHandler
## snappy\_mode
يتحكم هذا الإعداد في تنسيق wire المستخدم لضغط snappy لمسارات إدخال/إخراج الملفات العامة مثل `file` و`url`. ويستخدم HTTP `Content-Encoding: snappy` دائمًا تنسيق framing ويتجاهل هذا الإعداد.
لاحظ أن تنسيق كتل snappy الخام الناتج عن استدعاء واحد لـ `snappy::Compress` (على سبيل المثال، حمولات بروتوكول Prometheus البعيد التي يتعامل معها `SnappyBasicReadBuffer`) هو تنسيق wire منفصل وخاص بالبروتوكول، ولا يتحكم فيه هذا الإعداد.
القيم الممكنة:
* `basic` — تنسيق كتل Hadoop snappy. متوافق مع الملفات التي يقرأها Hadoop ويكتبها. يدعم القراءة والكتابة.
* `framed` — تنسيق framing لـ Snappy، وهو تنسيق البث القياسي الذي تحدده Google. يدعم القراءة والكتابة.
## sort\_overflow\_mode
يحدّد ما يحدث إذا تجاوز عدد الصفوف المستلَمة قبل الفرز أحد الحدود القصوى.
القيم الممكنة:
* `throw`: إثارة استثناء.
* `break`: إيقاف تنفيذ الاستعلام وإرجاع نتيجة جزئية.
## splitby\_max\_substrings\_includes\_remaining\_string
يتحكم هذا الإعداد في ما إذا كانت الدالة [splitBy\*()](/docs/ar/reference/functions/regular-functions/splitting-merging-functions) التي تستخدم الوسيط `max_substrings` > 0 ستضمّن السلسلة المتبقية في العنصر الأخير من مصفوفة النتيجة.
القيم الممكنة:
* `0` - لن تُضمَّن السلسلة المتبقية في العنصر الأخير من مصفوفة النتيجة.
* `1` - ستُضمَّن السلسلة المتبقية في العنصر الأخير من مصفوفة النتيجة. هذا هو سلوك الدالة [`split()`](https://spark.apache.org/docs/latest/api/python/reference/pyspark.sql/api/pyspark.sql.functions.split.html) في Spark والطريقة ['string.split()'](https://docs.python.org/3/library/stdtypes.html#str.split) في بايثون.
## stop\_refreshable\_materialized\_views\_on\_startup
عند بدء تشغيل الخادم، يمنع جدولة طرق العرض المادية القابلة للتحديث، كما لو تم استخدام SYSTEM STOP VIEWS. ويمكنك تشغيلها يدويًا بعد ذلك باستخدام `SYSTEM START VIEWS` أو `SYSTEM START VIEW `. وينطبق ذلك أيضًا على طرق العرض المنشأة حديثًا. ولا يؤثر هذا في طرق العرض المادية غير القابلة للتحديث.
## tcp\_keep\_alive\_timeout
الوقت بالثواني الذي يجب أن يبقى فيه الاتصال خاملاً قبل أن يبدأ TCP في إرسال مجسّات keepalive
## temporary\_data\_in\_cache\_reserve\_space\_wait\_lock\_timeout\_milliseconds
مدة الانتظار لقفل ذاكرة التخزين المؤقت لنظام الملفات عند حجز مساحة للبيانات المؤقتة
## throw\_if\_no\_data\_to\_insert
يسمح بعمليات INSERT الفارغة أو يمنعها، وهو مفعّل افتراضيًا (ويؤدي إلى ظهور خطأ عند تنفيذ عملية insert فارغة). لا ينطبق هذا إلا على عمليات INSERT التي تستخدم [`clickhouse-client`](/docs/ar/concepts/features/interfaces/cli) أو [واجهة gRPC](/docs/ar/concepts/features/interfaces/grpc).
## timeout\_before\_checking\_execution\_speed
يتحقق من أن سرعة التنفيذ ليست منخفضة جدًا (أي لا تقل عن `min_execution_speed`)،
وذلك بعد انقضاء الوقت المحدد بالثواني.
## transfer\_overflow\_mode
تحدد ما يحدث عند تجاوز كمية البيانات أحد الحدود.
القيم الممكنة:
* `throw`: إثارة استثناء (الافتراضي).
* `break`: إيقاف تنفيذ الاستعلام وإرجاع نتيجة جزئية، كما لو كانت
بيانات المصدر قد نفدت.
## transform\_null\_in
يُمكّن اعتبار قيم [NULL](/docs/ar/reference/syntax#null) متساوية عند استخدام عامل التشغيل [IN](/docs/ar/reference/statements/in).
بشكل افتراضي، لا يمكن مقارنة قيم `NULL` لأن `NULL` تعني قيمة غير معرّفة. لذلك، يجب أن تُرجع المقارنة `expr = NULL` دائمًا `false`. ومع هذا الإعداد، تُرجع `NULL = NULL` القيمة `true` مع عامل التشغيل `IN`.
القيم الممكنة:
* 0 — تُرجع مقارنة قيم `NULL` في عامل التشغيل `IN` القيمة `false`.
* 1 — تُرجع مقارنة قيم `NULL` في عامل التشغيل `IN` القيمة `true`.
**مثال**
لنأخذ الجدول `null_in`:
```text theme={null}
┌──idx─┬─────i─┐
│ 1 │ 1 │
│ 2 │ NULL │
│ 3 │ 3 │
└──────┴───────┘
```
الاستعلام:
```sql theme={null}
SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 0;
```
النتيجة:
```text theme={null}
┌──idx─┬────i─┐
│ 1 │ 1 │
└──────┴──────┘
```
الاستعلام:
```sql theme={null}
SELECT idx, i FROM null_in WHERE i IN (1, NULL) SETTINGS transform_null_in = 1;
```
النتيجة:
```text theme={null}
┌──idx─┬─────i─┐
│ 1 │ 1 │
│ 2 │ NULL │
└──────┴───────┘
```
**انظر أيضًا**
* [معالجة NULL في عوامل التشغيل `IN`](/docs/ar/reference/statements/in#null-processing)
## traverse\_shadow\_remote\_data\_paths
اجتز البيانات المجمّدة (دليل الظل) بالإضافة إلى بيانات الجدول الفعلية عند تنفيذ استعلام على system.remote\_data\_paths
## union\_default\_mode
يحدد وضعًا لدمج نتائج استعلام `SELECT`. لا يُستخدم هذا الإعداد إلا مع [UNION](/docs/ar/reference/statements/select/union) عند عدم تحديد `UNION ALL` أو `UNION DISTINCT` صراحةً.
القيم المحتملة:
* `'DISTINCT'` — يُخرج ClickHouse الصفوف الناتجة عن دمج الاستعلامات بعد إزالة الصفوف المكررة.
* `'ALL'` — يُخرج ClickHouse جميع الصفوف الناتجة عن دمج الاستعلامات، بما في ذلك الصفوف المكررة.
* `''` — يُنشئ ClickHouse استثناءً عند استخدامه مع `UNION`.
راجع الأمثلة في [UNION](/docs/ar/reference/statements/select/union).
## unique\_key\_max\_encoded\_size
الحد الأقصى للحجم (بالبايت) للترميز الثنائي الذي يحافظ على الترتيب لصف واحد من `UNIQUE KEY`.
## unknown\_packet\_in\_send\_data
أرسل حزمة غير معروفة بدلًا من حزمة البيانات رقم N
## variant\_throw\_on\_type\_mismatch
عند تطبيق دالة على عمود [Variant](/docs/ar/reference/data-types/variant) باستخدام التنفيذ الافتراضي،
يحدد هذا الإعداد ما يحدث للصفوف التي يكون نوعها الفعلي غير متوافق مع الدالة:
* `true` (الافتراضي) — طرح استثناء.
* `false` — إرجاع `NULL` لهذه الصفوف بدلًا من ذلك.
## wait\_changes\_become\_visible\_after\_commit\_mode
انتظر حتى تصبح التغييرات التي تم تثبيتها مرئية فعليًا في أحدث لقطة
## عبء العمل
اسم عبء العمل المُستخدَم للوصول إلى الموارد
## write\_full\_path\_in\_iceberg\_metadata
يكتب المسارات الكاملة (بما في ذلك s3://) في ملفات البيانات الوصفية لـ Iceberg.
## zstd\_window\_log\_max
يسمح لك بتحديد القيمة القصوى لـ window log في ZSTD (لن يُستخدم مع عائلة MergeTree)