> ## 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.

> Retorna um array dos valores mais frequentes, de forma aproximada, na coluna especificada. O array resultante é ordenado em ordem decrescente da frequência aproximada dos valores (e não pelos próprios valores). Além disso, o peso do valor é levado em consideração.

# topKWeighted

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

Introduzido em: v1.1.0

Retorna um array dos valores mais frequentes aproximados na coluna especificada.
O array resultante é ordenado em ordem decrescente da frequência aproximada dos valores (e não dos próprios valores).
Além disso, o peso do valor é levado em consideração.

**Veja também**

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

**Sintaxe**

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

**Parâmetros**

* `N` — Número de elementos a serem retornados. Valor padrão: 10. [`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 devem ser encontrados os valores mais frequentes. - `weight` — O peso. Cada valor é contabilizado `weight` vezes no cálculo da frequência. [`UInt64`](/pt-BR/reference/data-types/int-uint)

**Valor retornado**

Retorna um array com os valores que têm a maior soma aproximada de pesos. [`Array`](/pt-BR/reference/data-types/array)

**Exemplos**

**Exemplo de uso**

```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']              │
└────────────────────────┘
```

**Com o parâmetro `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)]              │
└─────────────────────────────────────┘
```

**Veja também**

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