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

> 지정된 컬럼에서 대략적으로 가장 자주 나타나는 값들의 배열을 반환합니다. 반환되는 배열은 값 자체가 아니라 각 값의 대략적인 빈도를 기준으로 내림차순 정렬됩니다.

# topK

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

도입 버전: v1.1.0

지정된 컬럼에서 대략적으로 가장 빈도가 높은 값들의 배열을 반환합니다. 결과 배열은 값 자체가 아니라 값의 대략적인 출현 빈도를 기준으로 내림차순 정렬됩니다.

TopK를 분석하기 위해 [Parallel Space Saving](https://doi.org/10.1016/j.ins.2015.09.003)의 reduce-and-combine 알고리즘을 기반으로 한 [Filtered Space-Saving](https://doi.org/10.1016/j.ins.2010.08.024) 알고리즘을 구현합니다.

이 함수는 보장된 결과를 제공하지 않습니다. 특정 상황에서는 오차가 발생할 수 있으며, 가장 빈도가 높은 값이 아닌 자주 나타나는 값을 반환할 수 있습니다.

**관련 항목**

* [topKWeighted](/ko/reference/functions/aggregate-functions/topKWeighted)
* [approx\_top\_k](/ko/reference/functions/aggregate-functions/approxtopk)
* [approx\_top\_sum](/ko/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`](/ko/reference/data-types/int-uint)
* `load_factor` — 선택 사항입니다. 값을 위해 예약할 cell의 개수를 지정합니다. `uniq(column) > N * load_factor`이면 topK 함수의 결과는 근사값이 됩니다. 기본값은 3입니다. [`UInt64`](/ko/reference/data-types/int-uint)
* `counts` — 선택 사항입니다. 결과에 근사 개수와 오류 값이 포함될지 여부를 지정합니다. [`Bool`](/ko/reference/data-types/boolean)

**인수**

* `column` — 가장 자주 나타나는 값을 찾을 컬럼의 이름입니다. [`String`](/ko/reference/data-types/string)

**반환 값**

근사 빈도를 기준으로 내림차순 정렬된, 대략적으로 가장 자주 나타나는 값들의 배열을 반환합니다. [`Array`](/ko/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](/ko/reference/functions/aggregate-functions/topKWeighted)
* [approx\_top\_k](/ko/reference/functions/aggregate-functions/approxtopk)
* [approx\_top\_sum](/ko/reference/functions/aggregate-functions/approxtopsum)