Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Funzione COLLECT\$1LIST
<a name="COLLECT_LIST"></a>

La funzione COLLECT\$1LIST raccoglie e restituisce un elenco di elementi non unici. 

Questo tipo di funzione è utile quando si desidera raccogliere più valori da un insieme di righe in una singola matrice o struttura di dati di elenco.

**Nota**  
La funzione non è deterministica perché l'ordine dei risultati raccolti dipende dall'ordine delle righe, che può essere non deterministico dopo l'esecuzione di un'operazione di shuffle.

## Sintassi
<a name="COLLECT_LIST-syntax"></a>

```
collect_list(expr)
```

## Arguments (Argomenti)
<a name="COLLECT_LIST-arguments"></a>

 *expr*   
Un'espressione di qualsiasi tipo.

## Valori restituiti
<a name="COLLECT_LIST-returns"></a>

Restituisce un ARRAY del tipo di argomento. L'ordine degli elementi nell'array non è deterministico. 

I valori NULL sono esclusi.

Se viene specificato DISTINCT, la funzione raccoglie solo valori univoci ed è sinonimo di funzione aggregata. `collect_set `

## Esempio
<a name="COLLECT_LIST-example"></a>

La seguente query raccoglie tutti i valori dalla colonna col in un elenco. La `VALUES` clausola viene utilizzata per creare una tabella in linea con tre righe, in cui ogni riga ha una singola colonna con i valori 1, 2 e 1 rispettivamente. La `collect_list() ` funzione viene quindi utilizzata per aggregare tutti i valori della colonna col in un unico array. L'output di questa istruzione SQL sarebbe l'array`[1,2,1]`, che contiene tutti i valori della colonna col nell'ordine in cui sono apparsi nei dati di input.

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