collect_list (función de agregado)

  • Artículo

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Devuelve una matriz que contiene todos los valores de expr dentro del grupo. Esta función es un sinónimo para la función de agregado array_agg.

Sintaxis

collect_list ( [ALL | DISTINCT] expr ) [FILTER ( WHERE cond ) ]

Esta función también se puede invocar como una función de ventana mediante la cláusula OVER.

Argumentos

  • expr: una expresión de cualquier tipo.
  • cond: una expresión booleana opcional que filtra las filas usadas para la agregación.

Devoluciones

Una matriz del tipo de argumento.

El orden de los elementos de la matriz no es determinista. Se excluyen los valores de NULL.

Si se especifica DISTINCT, la función recopila solo valores únicos y es un sinónimo de la función de agregado collect_set.

Ejemplos

> SELECT collect_list(col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2,1]

> SELECT collect_list(DISTINCT col) FROM VALUES (1), (2), (NULL), (1) AS tab(col);
 [1,2]