collect_list агрегатная функция

  • Статья

Область применения:проверка помечено да Databricks SQL проверка помечено да Databricks Runtime

Возвращает массив, состоящий из всех значений в expr группе. Эта функция является синонимом агрегатной функции array_agg.

Синтаксис

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

Эту функцию также можно вызвать как оконную функцию с помощью OVER предложения .

Аргументы

  • expr: выражение любого типа.
  • cond: необязательное логическое выражение, фильтрующее строки, используемые для агрегирования.

Возвращает

МАССИВ типа аргумента.

Порядок элементов в массиве не детерминирован. NULL Значения исключаются.

Если DISTINCT указан параметр , функция собирает только уникальные значения и является синонимом агрегатной функции collect_set.

Примеры

> 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]