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

> Devuelve un array con los valores aproximadamente más frecuentes de la columna especificada. El array resultante se ordena de forma descendente según la frecuencia aproximada de los valores (no según los valores en sí). Además, se tiene en cuenta el peso del valor.

# topKWeighted

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

Introducido en: v1.1.0

Devuelve un array con los valores más frecuentes, de forma aproximada, de la columna especificada.
El array resultante se ordena en orden descendente según la frecuencia aproximada de los valores (no según los valores en sí).
Además, se tiene en cuenta el peso del valor.

**Véase también**

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

**Sintaxis**

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

**Parámetros**

* `N` — El número de elementos que se devolverán. Valor predeterminado: 10. [`UInt64`](/es/reference/data-types/int-uint)
* `load_factor` — Opcional. Define cuántas celdas se reservan para los valores. Si `uniq(column) > N * load_factor`, el resultado de la función topK será aproximado. Valor predeterminado: 3. [`UInt64`](/es/reference/data-types/int-uint)
* `counts` — Opcional. Define si el resultado debe incluir un recuento aproximado y un valor de error. [`Bool`](/es/reference/data-types/boolean)

**Argumentos**

* `column` — El nombre de la columna en la que se buscan los valores más frecuentes. - `weight` — El peso. Cada valor se contabiliza `weight` veces al calcular la frecuencia. [`UInt64`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve un array con los valores cuya suma aproximada de pesos es máxima. [`Array`](/es/reference/data-types/array)

**Ejemplos**

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

**Con el 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)]              │
└─────────────────────────────────────┘
```

**Véase también**

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