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

StarRocks 中文参考:array_generate

· 52CE 我爱测

# array_generate 生成一个包含数值元素的数组,数值范围在 和 之间,步长为 。 该函数从 3.1 开始支持。 ## 语法 ## 参数说明 - :可选参数。支持数据类型为 TINYINT、SMALLINT、INT、BIGINT、LARGEINT 的常量或列。如果不指定,默认值为 1。 - :必选参数。支持数据类型为 TINYINT、SMALLINT、INT、BIGINT、LARGEINT 的常量或列。 - :可选参数。支持

array_generate

生成一个包含数值元素的数组,数值范围在 start 和 end 之间,步长为 step。

该函数从 3.1 开始支持。

语法

ARRAY array_generate([start,] end [, step])

参数说明

  • start:可选参数。支持数据类型为 TINYINT、SMALLINT、INT、BIGINT、LARGEINT 的常量或列。如果不指定,默认值为 1。
  • end:必选参数。支持数据类型为 TINYINT、SMALLINT、INT、BIGINT、LARGEINT 的常量或列。
  • step:可选参数。支持数据类型为 TINYINT、SMALLINT、INT、BIGINT、LARGEINT 的常量或列。当 start < end 时, 如果不指定,默认值为 1。当 start > end 时,如果不指定,默认值为 -1。

返回值说明

返回值的数据类型为 ARRAY。数组中的元素类型与输入参数的类型相同。

注意事项

  • 当任意参数为列时,需指定列所属的表。
  • 当任意参数为列时,其他参数必须指定,不支持使用默认值。
  • 当任意参数为 NULL 时,结果返回 NULL。
  • 当 step = 0 时,返回空数组。
  • 当 start = end 时,返回该值。

示例

输入参数为常量的情况

mysql> select array_generate(9);
+---------------------+
| array_generate(9)   |
+---------------------+
| [1,2,3,4,5,6,7,8,9] |
+---------------------+

mysql> select array_generate(9,12);
+-----------------------+
| array_generate(9, 12) |
+-----------------------+
| [9,10,11,12]          |
+-----------------------+

mysql> select array_generate(9,6);
+----------------------+
| array_generate(9, 6) |
+----------------------+
| [9,8,7,6]            |
+----------------------+

mysql> select array_generate(9,6,-1);
+--------------------------+
| array_generate(9, 6, -1) |
+--------------------------+
| [9,8,7,6]                |
+--------------------------+

mysql> select array_generate(3,3);
+----------------------+
| array_generate(3, 3) |
+----------------------+
| [3]                  |
+----------------------+

输入参数为列的情况

CREATE TABLE `array_generate`
(
  `c1` TINYINT,
  `c2` SMALLINT,
  `c3` INT
)
ENGINE = OLAP
DUPLICATE KEY(`c1`)
DISTRIBUTED BY HASH(`c1`);

INSERT INTO `array_generate` VALUES
(1, 6, 3),
(2, 9, 4);
mysql> select array_generate(1,c2,2) from `array_generate`;
+--------------------------+
| array_generate(1, c2, 2) |
+--------------------------+
| [1,3,5]                  |
| [1,3,5,7,9]              |
+--------------------------+

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

资料来源与适用范围

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

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

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