array_prepend：数组前置元素
速查结论
array_prepend(array, element) 是 Spark SQL 中用于在数组开头添加一个元素的函数。
语法
array_prepend(array, element)
参数说明
| 参数 | 说明 |
|---|---|
array | 目标数组 |
element | 要添加到数组开头的元素，类型应与数组元素类型相同 |
示例
> SELECT array_prepend(array('b', 'd', 'c', 'a'), 'd');
["d","b","d","c","a"]
> SELECT array_prepend(array(1, 2, 3, null), null);
[null,1,2,3,null]
> SELECT array_prepend(CAST(null as Array<Int>), 2);
NULL
常见报错与避坑指南
- NULL 数组返回 NULL：如果传入的数组本身为 NULL，函数直接返回 NULL，不会添加元素。
- 空元素正常添加：NULL 值也可以被添加到数组开头，不会因 NULL 而拒绝操作。
- 元素类型需匹配：待添加的元素类型需与数组元素类型兼容，否则会抛出类型不匹配异常。
Since: 3.5.0
📱关注公众号
「数据仓库技术」文章同步更新，不错过每一篇干货
💬加群交流
备注「数据仓库技术」加入社群，每日一道大厂SQL真题
