sequence 函数

  • 项目

适用于：check marked yes Databricks SQL check marked yes Databricks Runtime

生成一个数组，其中包含从 start 到 stop（含）的元素，这些元素按 step 递增。

语法

sequence(start, stop [, step] )

参数

  • start：整数类型、DATE 或 TIMESTAMP 的表达式。
  • stop：如果 start 是数字，则为整数，否则为 DATE 或 TIMESTAMP。
  • step：如果 start 是 DATE 或 TIMESTAMP，则为 INTERVAL 表达式；否则为整数。

返回

start 和 stop 的最不常见类型的 ARRAY。

默认情况下，如果 start 小于或等于 stop，则 step 为 1，否则为 -1。

对于 DATE 或 TIMESTAMP 序列，默认 step 为 INTERVAL “1”DAY，INTERVAL 为“-1”DAY。

如果 start 大于 stop，则 step 必须为负数，反之亦然。

示例

> SELECT sequence(1, 5);
 [1,2,3,4,5]

> SELECT sequence(5, 1);
 [5,4,3,2,1]

> SELECT sequence(DATE'2018-01-01', DATE'2018-03-01', INTERVAL 1 MONTH);
 [2018-01-01,2018-02-01,2018-03-01]