ClickHouse/docs/zh/sql-reference/aggregate-functions/reference/grouparraysample.md

slug	sidebar_position
/zh/sql-reference/aggregate-functions/reference/grouparraysample	114

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'] │
└─────────────────────────────────────────────┘