大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:ARRAY_SHUFFLE

· 52CE 我爱测

随机打乱数组内元素的顺序,保留元素及其数量。输入数组或种子为 NULL 时返回 NULL。 是此函数的别名。

描述

随机打乱数组内元素的顺序,保留元素及其数量。输入数组或种子为 NULL 时返回 NULL。SHUFFLE 是此函数的别名。

Doris 4.1 系列自 4.1.5 起,seed 必须是常量,支持任意 BIGINT 值,包括负数,并使用全部 64 位。常量数组也会逐行打乱,因此相同种子的结果可能与旧版本不同。此前的 4.1 版本只使用每批第一行的种子,负数或大于 4294967295 的种子会报错,常量数组在每行得到相同顺序。

语法

ARRAY_SHUFFLE(<arr> [, <seed>])

参数

参数 说明
<arr> ARRAY 类型,待打乱的数组。
<seed> 可选,BIGINT 类型的常量随机种子,支持常量表达式。省略时,每批数据使用新的随机种子。

返回值

返回与输入数组同类型的数组,元素被随机重排,元素数量与类型保持不变。输入数组或种子为 NULL 时返回 NULL,空数组返回空数组。

数据按批处理。指定种子时,每批都从该种子开始生成随机序列,批内各行依次使用这个序列。因此多行数据中某一行的排列可能随分批方式变化;指定种子不保证所有相同数组的排列相同。常量数组也逐行打乱。

示例

打乱后,排序可验证元素保持不变。使用负数种子或常量表达式均有效:

SELECT ARRAY_SORT(ARRAY_SHUFFLE([1, 2, 3, 4], -1)),
       ARRAY_SORT(ARRAY_SHUFFLE([1, 2, 3, 4], 1 + 1));
[1, 2, 3, 4]    [1, 2, 3, 4]

NULL 和空数组:

SELECT ARRAY_SHUFFLE(CAST(NULL AS ARRAY<INT>), 1),
       ARRAY_SHUFFLE([1, 2, 3], NULL), ARRAY_SHUFFLE([], 1);
NULL    NULL    []

使用列作为种子会报错,错误信息包含以下内容:

SELECT ARRAY_SHUFFLE([1, 2, 3], number) FROM numbers("number" = "2");
The seed of array_shuffle must be a constant

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。