> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# إعدادات الجلسة group_by_*
> إعدادات الجلسة في ClickHouse ضمن المجموعة المُولَّدة group_by_*.
export const ExperimentalBadge = () => {
return
ميزة تجريبية
;
};
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
سجل الإصدارات
{headers.map(header => |
{header}
| )}
{rows.map((row, row_index) =>
{(row.items ?? []).map((item, item_index) => |
{item?.label}
| )}
)}
;
};
export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => {
return
النوع
{type}
القيمة الافتراضية
{default_value}
{changeable_without_restart &&
يمكن تغييره دون إعادة التشغيل
}
{changeable_without_restart &&
{changeable_without_restart}
}
;
};
تتوفر هذه الإعدادات في [system.settings](/ar/reference/system-tables/settings)، وهي مُولَّدة تلقائيًا من [المصدر](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp).
## group\_by\_overflow\_mode
يحدد ما يحدث عندما يتجاوز عدد المفاتيح الفريدة للتجميع الحد المسموح به:
* `throw`: طرح استثناء
* `break`: إيقاف تنفيذ الاستعلام وإرجاع النتيجة الجزئية
* `any`: متابعة التجميع للمفاتيح التي دخلت إلى المجموعة، ولكن من دون إضافة مفاتيح جديدة إليها.
يتيح لك استخدام القيمة 'any' تشغيل تقريب لـ GROUP BY. وتعتمد جودة
هذا التقريب على الطبيعة الإحصائية للبيانات.
## group\_by\_top\_k\_optimization\_observation\_rows
بالنسبة إلى `enable_group_by_top_k_optimization`: عدد الصفوف التي يراقبها كل تدفق تجميع قبل تجميد كومة top-K ممتلئة تخطّت أقل من 10% من صفوف الإدخال وأخرجت مفاتيح أقل من سعتها. وتعني الكومة المجمّدة أن التجميع يستمر كما لو كان التحسين معطّلًا.
تبلغ النافذة الفعلية ضعفي الحجم المحجوز للكومة على الأقل، لذا تتاح للكومة دائمًا فرصة للامتلاء قبل تقييمها. تعطل القيمة `0` هذا التجميد (مع استمرار تجميد الكومة عندما تتجاوز مجموعة التعادلات عند الحد سعتها).
لا يؤثر هذا في استعلامات `GROUP BY keys LIMIT K` التي لا تتضمن `ORDER BY`، إذ يكون التجميد معطّلًا دائمًا فيها: تتضمن خطة هذا النمط ترتيبًا مُنشأً لا يحقق فائدة إلا ما دامت الكومة تحدّ من حجم جدول التجزئة، لذا فإن تجميد الكومة سيُبقي خطة أبطأ من الخطة غير المحسّنة.
## group\_by\_two\_level\_threshold
يبدأ التجميع ثنائي المستوى عند هذا العدد من المفاتيح. 0 - العتبة غير معيّنة.
## group\_by\_two\_level\_threshold\_bytes
اعتبارًا من أي حجم، بالبايت، لحالة التجميع يبدأ استخدام التجميع ثنائي المستوى. 0 - يعني أن العتبة غير معيّنة. ويُستخدم التجميع ثنائي المستوى عند تفعيل واحدة على الأقل من العتبات.
## group\_by\_use\_nulls
يغيّر الطريقة التي يتعامل بها [بند GROUP BY](/ar/reference/statements/select/group-by) مع أنواع مفاتيح التجميع.
عند استخدام المحددات `ROLLUP` أو `CUBE` أو `GROUPING SETS`، قد لا تُستخدم بعض مفاتيح التجميع في إنتاج بعض صفوف النتائج.
تُملأ الأعمدة الخاصة بهذه المفاتيح إما بالقيمة الافتراضية أو بـ `NULL` في الصفوف المقابلة، وذلك وفقًا لهذا الإعداد.
القيم الممكنة:
* 0 — تُستخدم القيمة الافتراضية لنوع مفتاح التجميع لتمثيل القيم المفقودة.
* 1 — ينفّذ ClickHouse `GROUP BY` بالطريقة نفسها التي يحددها معيار SQL. وتُحوَّل أنواع مفاتيح التجميع إلى [Nullable](/ar/reference/data-types/nullable). وتُملأ الأعمدة الخاصة بمفاتيح التجميع المقابلة بقيمة [NULL](/ar/reference/syntax#null) في الصفوف التي لم تُستخدم فيها.
انظر أيضًا:
* [بند GROUP BY](/ar/reference/statements/select/group-by)