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

关注公众号

加群交流

赞赏