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

StarRocks 中文参考:array_sort

· 52CE 我爱测

# array_sort 按升序对数组元素进行排序。从 v4.0 开始, 支持 Lambda Comparator。 ## 语法 ## 参数 :要排序的数组元素。仅支持 ARRAY 数据类型。 :一个可选的 lambda 函数比较器,格式为 。lambda Comparator 必须满足以下条件: - 必须只依赖于参数 x 和 y - 必须返回布尔或数字类型 - 结果不应为 NULL - 必须满足严格弱序要求 ## 返回值 返回一个数组

array_sort

按升序对数组元素进行排序。从 v4.0 开始,array_sort 支持 Lambda Comparator。

语法

-- 不使用 Lambda Comparator
array_sort(array)

-- 使用 Lambda Comparator
array_sort(array, (x,y)->expr(x,y))

参数

array:要排序的数组元素。仅支持 ARRAY 数据类型。

lambda_comparator:一个可选的 lambda 函数比较器,格式为 (x,y)->expr(x,y)。lambda Comparator 必须满足以下条件:

  • 必须只依赖于参数 x 和 y
  • 必须返回布尔或数字类型
  • 结果不应为 NULL
  • 必须满足严格弱序要求

返回值

返回一个数组。

使用说明

基本排序

  • 当不使用 lambda Comparator 时,此函数按升序对数组元素进行排序。
  • NULL 值放置在返回数组的开头。
  • 返回数组的元素与输入数组的元素具有相同的数据类型。

Lambda Comparator 排序

  • 使用 lambda Comparator 时,排序顺序由表达式结果决定:

    • 对于布尔返回值:true 表示 x 应在 y 之前
    • 对于数字返回值:负数表示 x 在 y 之前
  • lambda Comparator 必须满足严格弱序要求:

    • 非自反性: 对于所有 x,expr(x, x) 必须返回 false(布尔)或非负数(数字)
    • 不对称性: 如果 expr(x, y) 成立,则 expr(y, x) 不得成立
    • 传递性: 如果 expr(x, y) 和 expr(y, z) 成立,则 expr(x, z) 必须成立
    • 连通性: 对于所有 x 和 y,以下之一必须为真:
      • expr(x, y)
      • expr(y, x)
      • x = y
  • lambda Comparator 表达式必须:

    • 只依赖于参数 x 和 y
    • 返回布尔或数字类型
    • 从不返回 NULL
    • 始终为相同的输入值生成一致的结果

降序

如果要按降序对数组元素进行排序,请使用 reverse 函数。

示例

基本示例

下表用作示例:

mysql> select * from test;
+------+--------------+
| c1   | c2           |
+------+--------------+
|    1 | [4,3,null,1] |
|    2 | NULL         |
|    3 | [null]       |
|    4 | [8,5,1,4]    |
+------+--------------+

按列 c2 的值按升序排序。

mysql> select c1, array_sort(c2) from test;
+------+------------------+
| c1   | array_sort(`c2`) |
+------+------------------+
|    1 | [null,1,3,4]     |
|    2 | NULL             |
|    3 | [null]           |
|    4 | [1,4,5,8]        |
+------+------------------+

Lambda Comparator 示例

使用 lambda Comparator 按降序对整数数组进行排序:

mysql> select array_sort([3,1,4,2], (x,y) -> x > y);
+-------------------------------------------+
| array_sort([3, 1, 4, 2], (x, y) -> x > y) |
+-------------------------------------------+
| [4, 3, 2, 1]                              |
+-------------------------------------------+

使用数值返回值对整数数组进行排序:

mysql> select array_sort([3,1,4,2], (x,y) -> x - y);
+-------------------------------------------+
| array_sort([3, 1, 4, 2], (x, y) -> x - y) |
+-------------------------------------------+
| [1, 2, 3, 4]                              |
+-------------------------------------------+

按长度对字符串数组进行排序:

mysql> select array_sort(['apple', 'banana', 'cherry', 'date'], (x,y) -> length(x) - length(y));
+------------------------------------------------------------------------------------+
| array_sort(['apple', 'banana', 'cherry', 'date'], (x, y) -> length(x) - length(y)) |
+------------------------------------------------------------------------------------+
| ['date', 'apple', 'banana', 'cherry']                                              |
+------------------------------------------------------------------------------------+

使用布尔返回值按字母顺序对字符串数组进行排序:

mysql> select array_sort(['banana', 'apple', 'cherry'], (x,y) -> x > y);
+------------------------------------------------------------+
| array_sort(['banana', 'apple', 'cherry'], (x, y) -> x > y) |
+------------------------------------------------------------+
| ['apple', 'banana', 'cherry']                              |
+------------------------------------------------------------+

使用自定义业务逻辑对数组进行排序(先排序偶数,后排序奇数):

mysql> select array_sort([5,2,8,1,9,4], (x,y) -> 
    case when x % 2 = 0 and y % 2 = 0 then x - y
         when x % 2 = 0 and y % 2 = 1 then -1
         when x % 2 = 1 and y % 2 = 0 then 1
         else x - y end);
+--------------------------------------------------------------------------------------------------------------------+
| array_sort([5, 2, 8, 1, 9, 4], (x, y) -> case when x % 2 = 0 and y % 2 = 0 then x - y when x % 2 = 0 and y % 2 = 1 then -1 when x % 2 = 1 and y % 2 = 0 then 1 else x - y end) |
+--------------------------------------------------------------------------------------------------------------------+
| [2, 4, 8, 1, 5, 9]                                                                                                 |
+--------------------------------------------------------------------------------------------------------------------+

使用自定义精度比较对小数数组进行排序:

mysql> select array_sort([3.141, 2.718, 1.414, 2.236], (x,y) -> round(x, 2) - round(y, 2));
+----------------------------------------------------------------------------------------+
| array_sort([3.141, 2.718, 1.414, 2.236], (x, y) -> round(x, 2) - round(y, 2))          |
+----------------------------------------------------------------------------------------+
| [1.414, 2.236, 2.718, 3.141]                                                           |
+----------------------------------------------------------------------------------------+

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

资料来源与适用范围

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

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

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