> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> يعيد مصفوفة بالقيم الأكثر تكرارًا على نحو تقريبي في العمود المحدد. تُرتَّب المصفوفة الناتجة ترتيبًا تنازليًا حسب التكرار التقريبي للقيم (وليس حسب القيم نفسها). بالإضافة إلى ذلك، يُؤخَذ وزن القيمة في الحسبان.

# topKWeighted

<div id="topKWeighted">
  ## topKWeighted
</div>

تم تقديمه في: v1.1.0

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

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

* [topK](/ar/reference/functions/aggregate-functions/topK)
* [approx\_top\_k](/ar/reference/functions/aggregate-functions/approxtopk)
* [approx\_top\_sum](/ar/reference/functions/aggregate-functions/approxtopsum)

**البنية**

```sql theme={null}
topKWeighted(N)(column, weight)
topKWeighted(N, load_factor)(column, weight)
topKWeighted(N, load_factor, 'counts')(column, weight)
```

**المعاملات**

* `N` — عدد العناصر المطلوب إرجاعها. القيمة الافتراضية: 10. [`UInt64`](/ar/reference/data-types/int-uint)
* `load_factor` — اختياري. يحدد عدد الخلايا المخصّصة للقيم. إذا كانت `uniq(column) > N * load_factor`، فستكون نتيجة الدالة topK تقريبية. القيمة الافتراضية: 3. [`UInt64`](/ar/reference/data-types/int-uint)
* `counts` — اختياري. يحدد ما إذا كان ينبغي أن تحتوي النتيجة على عدد تقريبي وقيمة خطأ. [`Bool`](/ar/reference/data-types/boolean)

**الوسيطات**

* `column` — اسم العمود المطلوب العثور على القيم الأكثر تكرارًا فيه. - `weight` — الوزن. تُحتسب كل قيمة بعدد `weight` مرات عند حساب التكرار. [`UInt64`](/ar/reference/data-types/int-uint)

**القيمة المُعادة**

يعيد مصفوفة من القيم ذات أكبر مجموع تقريبي للأوزان. [`Array`](/ar/reference/data-types/array)

**أمثلة**

**مثال على الاستخدام**

```sql title=Query theme={null}
SELECT topKWeighted(2)(k, w) FROM
VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
```

```response title=Response theme={null}
┌─topKWeighted(2)(k, w)──┐
│ ['z','x']              │
└────────────────────────┘
```

**باستخدام المعلَمة counts**

```sql title=Query theme={null}
SELECT topKWeighted(2, 10, 'counts')(k, w)
FROM VALUES('k Char, w UInt64', ('y', 1), ('y', 1), ('x', 5), ('y', 1), ('z', 10));
```

```response title=Response theme={null}
┌─topKWeighted(2, 10, 'counts')(k, w)─┐
│ [('z',10,0),('x',5,0)]              │
└─────────────────────────────────────┘
```

**راجع أيضًا**

* [topK](/ar/reference/functions/aggregate-functions/topK)
* [approx\_top\_k](/ar/reference/functions/aggregate-functions/approxtopk)
* [approx\_top\_sum](/ar/reference/functions/aggregate-functions/approxtopsum)