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

> Retorna um array com os valores aproximadamente mais frequentes na coluna especificada. O array resultante é ordenado em ordem decrescente da frequência aproximada desses valores (e não pelos próprios valores).

# topK

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

Introduzido em: v1.1.0

Retorna um array com os valores aproximadamente mais frequentes na coluna especificada. O array resultante é ordenado em ordem decrescente da frequência aproximada dos valores (não pelos próprios valores).

Implementa o algoritmo [Filtered Space-Saving](https://doi.org/10.1016/j.ins.2010.08.024) para analisar o TopK, com base no algoritmo reduce-and-combine de [Parallel Space Saving](https://doi.org/10.1016/j.ins.2015.09.003).

Esta função não fornece um resultado garantido. Em determinadas situações, podem ocorrer erros, e ela pode retornar valores frequentes que não são os mais frequentes.

**Veja também**

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

**Sintaxe**

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

**Parâmetros**

* `N` — O número de elementos a serem retornados. Valor padrão: 10. Valor máximo de `N = 65536`. [`UInt64`](/pt-BR/reference/data-types/int-uint)
* `load_factor` — Opcional. Define quantas células são reservadas para os valores. Se `uniq(column) > N * load_factor`, o resultado da função topK será aproximado. Valor padrão: 3. [`UInt64`](/pt-BR/reference/data-types/int-uint)
* `counts` — Opcional. Define se o resultado deve conter uma contagem aproximada e um valor de erro. [`Bool`](/pt-BR/reference/data-types/boolean)

**Argumentos**

* `column` — O nome da coluna para a qual serão encontrados os valores mais frequentes. [`String`](/pt-BR/reference/data-types/string)

**Valor retornado**

Retorna um array com os valores aproximadamente mais frequentes, ordenados em ordem decrescente de frequência aproximada. [`Array`](/pt-BR/reference/data-types/array)

**Exemplos**

**Exemplo de uso**

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

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

**Veja também**

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