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

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

# topK

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

قُدِّمت في: v1.1.0

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

تُطبّق خوارزمية [Filtered Space-Saving](https://doi.org/10.1016/j.ins.2010.08.024) لتحليل TopK، استنادًا إلى خوارزمية reduce-and-combine من [Parallel Space Saving](https://doi.org/10.1016/j.ins.2015.09.003).

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

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

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

**الصيغة**

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

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

* `N` — عدد العناصر المطلوب إرجاعها. القيمة الافتراضية: 10. الحد الأقصى للقيمة `N = 65536`. [`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` — اسم العمود المطلوب العثور على أكثر القيم تكرارًا فيه. [`String`](/ar/reference/data-types/string)

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

تعيد مصفوفة تضم أكثر القيم تكرارًا بشكل تقريبي، مرتبة ترتيبًا تنازليًا حسب التكرار التقريبي. [`Array`](/ar/reference/data-types/array)

**أمثلة**

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

```sql title=Query theme={null}
SELECT topK(3)(AirlineID) AS res
FROM ontime;
```

```response title=Response theme={null}
┌─res─────────────────┐
│ [19393,19790,19805] │
└─────────────────────┘
```

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

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