Share via


array_agg funzione di aggregazione

Si applica a:segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 10.4 LTS e versioni successive

Restituisce una matrice costituita da tutti i valori all'interno expr del gruppo. Questa funzione è un sinonimo di collect_list funzione di aggregazione.

Sintassi

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

Questa funzione può anche essere richiamata come funzione window usando la OVER clausola .

Argomenti

  • expr: espressione di qualsiasi tipo.
  • cond: espressione booleana facoltativa che filtra le righe usate per l'aggregazione.

Valori restituiti

Matrice del tipo di argomento.

L'ordine degli elementi nella matrice non è deterministico. NULL i valori vengono esclusi.

Se DISTINCT viene specificata la funzione raccoglie solo valori univoci ed è un sinonimo di collect_set funzione di aggregazione.

Esempi

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