跳到主要内容
版本:3.2

generate_series

功能

生成一系列从 startend 的数值,步长为 stepstep 默认为 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])

返回值说明

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

  • 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