mode

Devolve o valor mais frequente num grupo.

Sintaxe

from pyspark.sql import functions as sf

sf.mode(col, deterministic=False)

Parâmetros

Parâmetro	Tipo	Description
col	pyspark.sql.Column ou nome da coluna	Coluna alvo para calcular.
deterministic	bool, opcional	Se houver múltiplos resultados igualmente frequentes, devolve o mais baixo (por defeito é falso).

Devoluções

pyspark.sql.Column: o valor mais frequente num grupo.

Examples

from pyspark.sql import functions as sf
df = spark.createDataFrame([
    ("Java", 2012, 20000), ("dotNET", 2012, 5000),
    ("Java", 2012, 20000), ("dotNET", 2012, 5000),
    ("dotNET", 2013, 48000), ("Java", 2013, 30000)],
    schema=("course", "year", "earnings"))
df.groupby("course").agg(sf.mode("year")).sort("course").show()

+------+----------+
|course|mode(year)|
+------+----------+
|  Java|      2012|
|dotNET|      2012|
+------+----------+

Quando múltiplos valores têm a mesma maior frequência, então qualquer valor é devolvido se determinístico for falso ou não estiver definido, ou o valor mais baixo é devolvido se determinístico for verdadeiro.

from pyspark.sql import functions as sf
df = spark.createDataFrame([(-10,), (0,), (10,)], ["col"])
df.select(sf.mode("col", True)).show()

+---------------------------------------+
|mode() WITHIN GROUP (ORDER BY col DESC)|
+---------------------------------------+
|                                    -10|
+---------------------------------------+