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

StarRocks 中文参考:generate_series

· 52CE 我爱测

generate_series 是一个表函数。表函数为每个输入行返回一个行集合。返回的集合可以包含零行、一行或多行。每一行可以包含一个或多个列。

generate_series

生成一系列从 start 到 end 的数值,步长为 step,step 默认为 1。

generate_series 是一个表函数。表函数为每个输入行返回一个行集合。返回的集合可以包含零行、一行或多行。每一行可以包含一个或多个列。

在 StarRocks 中调用 generate_series() 时,如果输入参数为数值常量,则需要使用 TABLE() 关键字包裹 generate_series();如果输入参数为表达式,比如列名,则不需要使用 TABLE() 关键字包裹。具体参见示例。

该函数从 3.1 版本开始支持。

语法

generate_series(start, end [,step])

参数说明

  • start:起始值,必选。支持 INT、BIGINT、LARGEINT 类型。
  • end:结束值,必选。支持 INT、BIGINT、LARGEINT 类型。
  • step:数值递增或者递减的步长,可选。支持 INT、BIGINT、LARGEINT 类型。如果不指定,默认值为 1。step 取值不能为 0,否则报错。

三个参数的类型必须一致,比如 generate_series(INT start, INT end [, INT step])。

返回值说明

返回一系列数值,返回值的类型与参数 start 和 end 的类型相同。

  • 当 step 为正数时,如果 start 大于 end,则返回零行。相反,当 step 为负数时,如果 start 小于 end,则返回零行。
  • step 为 0 会返回错误。
  • 对 NULL 值的处理:输入参数为 literal null 时,会返回报错;输入参数为表达式,表达式的结果为 NULL 时,会返回零行,参见示例五。

示例

示例一:升序返回 2 到 5 之间的整数值,使用默认步长。

MySQL > select * from TABLE(generate_series(2, 5));
+-----------------+
| generate_series |
+-----------------+
|               2 |
|               3 |
|               4 |
|               5 |
+-----------------+

示例二:升序返回 2 和 5 之间的整数值,步长为 2。

MySQL > select * from TABLE(generate_series(2, 5, 2));
+-----------------+
| generate_series |
+-----------------+
|               2 |
|               4 |
+-----------------+

示例三:降序返回 5 和 2 之间的数值,步长为 -1。

MySQL > select * from TABLE(generate_series(5, 2, -1));
+-----------------+
| generate_series |
+-----------------+
|               5 |
|               4 |
|               3 |
|               2 |
+-----------------+

示例四:步长为负数,起始值小于结束值,返回零行。

MySQL > select * from TABLE(generate_series(2, 5, -1));
Empty set (0.01 sec)

示例五:使用表中的列作为 generate_series() 的输入参数。注意此时无需使用 TABLE()。当输入行有 NULL 时,对于该行会返回零行,比如下表中的 (NULL, 10)。

CREATE TABLE t_numbers(start INT, end INT)
DUPLICATE KEY (start)
DISTRIBUTED BY HASH(start) BUCKETS 1;

INSERT INTO t_numbers VALUES
(1, 3),
(5, 2),
(NULL, 10),
(4, 7),
(9,6);

SELECT * FROM t_numbers;
+-------+------+
| start | end  |
+-------+------+
|  NULL |   10 |
|     1 |    3 |
|     4 |    7 |
|     5 |    2 |
|     9 |    6 |
+-------+------+

-- 默认步长为 1,对数据行(1,3)和 (4,7) 升序返回多行。
SELECT * FROM t_numbers, generate_series(t_numbers.start, t_numbers.end);
+-------+------+-----------------+
| start | end  | generate_series |
+-------+------+-----------------+
|     1 |    3 |               1 |
|     1 |    3 |               2 |
|     1 |    3 |               3 |
|     4 |    7 |               4 |
|     4 |    7 |               5 |
|     4 |    7 |               6 |
|     4 |    7 |               7 |
+-------+------+-----------------+

-- 步长为 -1,对数据行(5,2)和 (9,6) 降序返回多行。
SELECT * FROM t_numbers, generate_series(t_numbers.start, t_numbers.end, -1);
+-------+------+-----------------+
| start | end  | generate_series |
+-------+------+-----------------+
|     5 |    2 |               5 |
|     5 |    2 |               4 |
|     5 |    2 |               3 |
|     5 |    2 |               2 |
|     9 |    6 |               9 |
|     9 |    6 |               8 |
|     9 |    6 |               7 |
|     9 |    6 |               6 |
+-------+------+-----------------+

keywords

表格函数,表函数,table function,generate series

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

资料来源与适用范围

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

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

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