groupArraySample

引数値のサンプル配列を作成します。結果として得られる配列のサイズは max_size 個の要素に制限されます。引数値はランダムに選択され、配列に追加されます。

構文

groupArraySample(max_size[, seed])(x)

引数

• max_size — 結果となる配列の最大サイズ。UInt64。
• seed — 乱数生成器のシード値。省略可能。UInt64。デフォルト値: 123456。
• x — 引数（列名または式）。

返される値

• 引数 x からランダムに選択された要素の配列。

型: Array。

例

テーブル colors を考えます:

┌─id─┬─color──┐
│  1 │ red    │
│  2 │ blue   │
│  3 │ green  │
│  4 │ white  │
│  5 │ orange │
└────┴────────┘

列名を引数に指定したクエリ：

SELECT groupArraySample(3)(color) as newcolors FROM colors;

結果：

┌─newcolors──────────────────┐
│ ['white','blue','green']   │
└────────────────────────────┘

列名と異なるシード値を指定したクエリ:

SELECT groupArraySample(3, 987654321)(color) as newcolors FROM colors;

結果：

┌─newcolors──────────────────┐
│ ['red','orange','green']   │
└────────────────────────────┘

引数に式を指定するクエリ：

SELECT groupArraySample(3)(concat('light-', color)) as newcolors FROM colors;

結果：

┌─newcolors───────────────────────────────────┐
│ ['light-blue','light-orange','light-green'] │
└─────────────────────────────────────────────┘