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

Apache Doris 中文参考:STACK

· 52CE 我爱测

将一组表达式拆分为固定数量的行。表达式按行优先顺序排列,与 Spark 和 Hive 的 函数兼容。 需要与 配合使用,将生成的列添加到每个输入行中。

描述

stack 将一组表达式拆分为固定数量的行。表达式按行优先顺序排列,与 Spark 和 Hive 的 stack 函数兼容。stack 需要与 LATERAL VIEW 配合使用,将生成的列添加到每个输入行中。

语法

STACK(<num_rows>, <expr1> [, <expr2> ...])

参数

参数 描述
<num_rows> 用于指定生成行数的正整数常量。支持 3 - 1 等常量表达式。
<expr1> [, <expr2> ...] 要分配到生成行中的表达式。同一输出列中的非 NULL 表达式必须具有完全相同的类型;必要时请显式转换。表达式可以引用输入行中的列。

返回值

返回 <num_rows> 行。输出列数等于表达式数量除以 <num_rows> 后向上取整的结果。每个输出列的类型为分配到该列的非 NULL 表达式的相同类型;如果某列只包含 NULL 表达式,则该列为 NULL 类型。值从左到右逐行分配。如果最后一行没有足够的表达式,缺少的值将使用 NULL 补齐。

生成多个输出列时,需要在 LATERAL VIEW 子句中指定别名来命名这些列。

使用说明

  1. <num_rows> 必须是正整数常量。列引用、非整数、零或负数均无效。
  2. 对于每个输出列,分配到该列的非 NULL 表达式必须具有相同类型。只包含 NULL 表达式的列为 NULL 类型。
  3. 值按行优先顺序排列:第一个输出行获得每个输出列的第一个值,第二个输出行获得每个输出列的第二个值,以此类推。
  4. stack 是表生成函数,通常与 LATERAL VIEW 配合使用。

示例

基本用法

SELECT c1, c2
FROM (SELECT 1) t
LATERAL VIEW stack(2, 1, 2, 3) s AS c1, c2
ORDER BY c1, c2;
+------+------+
| c1   | c2   |
+------+------+
|    1 |    2 |
|    3 | NULL |
+------+------+

行优先排列

SELECT c1, c2
FROM (SELECT 1) t
LATERAL VIEW stack(3, 1, 'a', 2, 'b', 3, 'c') s AS c1, c2
ORDER BY c1, c2;
+------+------+
| c1   | c2   |
+------+------+
|    1 | a    |
|    2 | b    |
|    3 | c    |
+------+------+

如果表达式数量不足以填满最后一行,缺少的值为 NULL:

SELECT c1
FROM (SELECT 1) t
LATERAL VIEW stack(4, 1, 2, 3) s AS c1
ORDER BY c1;
+------+
| c1   |
+------+
| NULL |
|    1 |
|    2 |
|    3 |
+------+

列表达式和类型检查

SELECT id, c1, c2
FROM (
    SELECT 1 AS id, 10 AS a, 'x' AS s1, 20 AS b, 'y' AS s2
) AS test_stack
LATERAL VIEW stack(2, a, s1, b, s2) s AS c1, c2
ORDER BY id, c1, c2;
+------+------+------+
| id   | c1   | c2   |
+------+------+------+
|    1 |   10 | x    |
|    1 |   20 | y    |
+------+------+------+

表达式会针对每个输入行求值。在本例中,a 和 b 组成一个输出列,s1 和 s2 组成另一个输出列。如果分配到同一输出列的表达式类型不兼容,查询将返回分析错误。

NULL 表达式可以与其他类型的值一起使用;NULL 值会在结果中作为补充值或原值保留。

显式 NULL 表达式会保留:

SELECT c1
FROM (SELECT 1) t
LATERAL VIEW stack(2, 1, NULL) s AS c1
ORDER BY c1;
+------+
| c1   |
+------+
| NULL |
|    1 |
+------+

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

资料来源与适用范围

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

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

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