翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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

COLLECT\$1LIST 関数は、一意でない要素のリストを収集して返します。

このタイプの関数は、行のセットから複数の値を単一の配列またはリストデータ構造に収集する場合に便利です。

**注記**  
収集された結果の順序は行の順序に依存するため、関数は非決定的です。シャッフル操作の実行後に非決定的になる可能性があります。

## 構文
<a name="COLLECT_LIST-syntax"></a>

```
collect_list(expr)
```

## 引数
<a name="COLLECT_LIST-arguments"></a>

 expr**   
任意のタイプの式。

## 戻り値
<a name="COLLECT_LIST-returns"></a>

引数タイプの ARRAY を返します。配列内の要素の順序は非決定的です。

NULL 値は除外されます。

DISTINCT が指定されている場合、関数は一意の値のみを収集し、`collect_set `集計関数のシノニムです。

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

次のクエリは、col 列からすべての値をリストに収集します。`VALUES` 句は、3 行のインラインテーブルを作成するために使用されます。各行の列列はそれぞれ 1、2、1 です。次に、 `collect_list() `関数を使用して、col 列のすべての値を 1 つの配列に集約します。この SQL ステートメントの出力は配列 となり`[1,2,1]`、入力データに表示された順序で col 列のすべての値が含まれます。

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